Repository URL to install this package:
|
Version:
2.1.0.jo1 ▾
|
<!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>