| |
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html><head><title>Python: module gdata.spreadsheet.service</title> |
| </head><body bgcolor="#f0f0f8"> |
| |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> |
| <tr bgcolor="#7799ee"> |
| <td valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.spreadsheet.html"><font color="#ffffff">spreadsheet</font></a>.service</strong></big></big></font></td |
| ><td align=right valign=bottom |
| ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/service.py</a></font></td></tr></table> |
| <p><tt><a href="#SpreadsheetsService">SpreadsheetsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google<br> |
| Spreadsheets operations.<br> |
| <br> |
| SpreadsheetService: Provides methods to query feeds and manipulate items.<br> |
| Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br> |
| <br> |
| DictionaryToParamList: Function which converts a dictionary into a list of<br> |
| URL arguments (represented as strings). This is a<br> |
| utility function used in CRUD operations.</tt></p> |
| <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#aa55cc"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td> |
| <td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br> |
| </td><td width="25%" valign=top><a href="gdata.html">gdata</a><br> |
| </td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ee77aa"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> |
| <td width="100%"><dl> |
| <dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>) |
| </font></dt><dd> |
| <dl> |
| <dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#Error">Error</a> |
| </font></dt><dd> |
| <dl> |
| <dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#RequestError">RequestError</a> |
| </font></dt></dl> |
| </dd> |
| </dl> |
| </dd> |
| <dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>) |
| </font></dt><dd> |
| <dl> |
| <dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#SpreadsheetsService">SpreadsheetsService</a> |
| </font></dt></dl> |
| </dd> |
| <dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>) |
| </font></dt><dd> |
| <dl> |
| <dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#CellQuery">CellQuery</a> |
| </font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#DocumentQuery">DocumentQuery</a> |
| </font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#ListQuery">ListQuery</a> |
| </font></dt></dl> |
| </dd> |
| </dl> |
| <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="CellQuery">class <strong>CellQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr> |
| |
| <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#CellQuery">CellQuery</a></dd> |
| <dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd> |
| <dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Data descriptors defined here:<br> |
| <dl><dt><strong>max_col</strong></dt> |
| <dd><tt>The max-col query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>max_row</strong></dt> |
| <dd><tt>The max-row query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>min_col</strong></dt> |
| <dd><tt>The min-col query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>min_row</strong></dt> |
| <dd><tt>The min-row query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>range</strong></dt> |
| <dd><tt>The range query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>return_empty</strong></dt> |
| <dd><tt>The return-empty query parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><a name="CellQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="CellQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br> |
| <br> |
| Args:<br> |
| feed: str (optional) The path for the feed (Examples: <br> |
| '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br> |
| text_query: str (optional) The contents of the q query parameter. The<br> |
| contents of the text_query are URL escaped upon conversion to a URI.<br> |
| params: dict (optional) Parameter value string pairs which become URL<br> |
| params when translated to a URI. These parameters are added to the<br> |
| query's items (key-value pairs).<br> |
| categories: list (optional) List of category strings which should be<br> |
| included as query categories. See <br> |
| <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br> |
| details. If you want to get results from category A or B (both <br> |
| categories), specify a single list item 'A|B'.</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>alt</strong></dt> |
| <dd><tt>The feed query's alt parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>author</strong></dt> |
| <dd><tt>The feed query's author parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>max_results</strong></dt> |
| <dd><tt>The feed query's max-results parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>orderby</strong></dt> |
| <dd><tt>The feed query's orderby parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_max</strong></dt> |
| <dd><tt>The feed query's published-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_min</strong></dt> |
| <dd><tt>The feed query's published-min parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>start_index</strong></dt> |
| <dd><tt>The feed query's start-index parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>text_query</strong></dt> |
| <dd><tt>The feed query's q parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_max</strong></dt> |
| <dd><tt>The feed query's updated-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_min</strong></dt> |
| <dd><tt>The feed query's updated-min parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><a name="CellQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CellQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br> |
| v defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br> |
| If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br> |
| 2-tuple; but raise KeyError if D is empty.</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CellQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br> |
| If E present and has a .<a href="#CellQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br> |
| If E present and lacks .<a href="#CellQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br> |
| In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-values">values</a>() -> list of D's values</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="CellQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl> |
| |
| <hr> |
| Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><strong>__hash__</strong> = None</dl> |
| |
| <dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CellQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
| |
| </td></tr></table> <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="DocumentQuery">class <strong>DocumentQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr> |
| |
| <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#DocumentQuery">DocumentQuery</a></dd> |
| <dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd> |
| <dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Data descriptors defined here:<br> |
| <dl><dt><strong>title</strong></dt> |
| <dd><tt>The title query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>title_exact</strong></dt> |
| <dd><tt>The title-exact query parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><a name="DocumentQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="DocumentQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br> |
| <br> |
| Args:<br> |
| feed: str (optional) The path for the feed (Examples: <br> |
| '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br> |
| text_query: str (optional) The contents of the q query parameter. The<br> |
| contents of the text_query are URL escaped upon conversion to a URI.<br> |
| params: dict (optional) Parameter value string pairs which become URL<br> |
| params when translated to a URI. These parameters are added to the<br> |
| query's items (key-value pairs).<br> |
| categories: list (optional) List of category strings which should be<br> |
| included as query categories. See <br> |
| <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br> |
| details. If you want to get results from category A or B (both <br> |
| categories), specify a single list item 'A|B'.</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>alt</strong></dt> |
| <dd><tt>The feed query's alt parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>author</strong></dt> |
| <dd><tt>The feed query's author parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>max_results</strong></dt> |
| <dd><tt>The feed query's max-results parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>orderby</strong></dt> |
| <dd><tt>The feed query's orderby parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_max</strong></dt> |
| <dd><tt>The feed query's published-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_min</strong></dt> |
| <dd><tt>The feed query's published-min parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>start_index</strong></dt> |
| <dd><tt>The feed query's start-index parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>text_query</strong></dt> |
| <dd><tt>The feed query's q parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_max</strong></dt> |
| <dd><tt>The feed query's updated-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_min</strong></dt> |
| <dd><tt>The feed query's updated-min parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><a name="DocumentQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#DocumentQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br> |
| v defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br> |
| If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br> |
| 2-tuple; but raise KeyError if D is empty.</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#DocumentQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br> |
| If E present and has a .<a href="#DocumentQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br> |
| If E present and lacks .<a href="#DocumentQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br> |
| In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-values">values</a>() -> list of D's values</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="DocumentQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl> |
| |
| <hr> |
| Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><strong>__hash__</strong> = None</dl> |
| |
| <dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#DocumentQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
| |
| </td></tr></table> <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr> |
| |
| <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> |
| <td colspan=2><tt>Base class for exceptions in this module.<br> </tt></td></tr> |
| <tr><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#Error">Error</a></dd> |
| <dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
| <dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Data descriptors defined here:<br> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
| <dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> |
| |
| <hr> |
| Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
| <dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
| |
| <hr> |
| Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
| <dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
| <br> |
| Use of negative indices is not supported.</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
| |
| <dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
| |
| <dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
| |
| <dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| </dl> |
| <dl><dt><strong>args</strong></dt> |
| </dl> |
| <dl><dt><strong>message</strong></dt> |
| </dl> |
| </td></tr></table> <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="ListQuery">class <strong>ListQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr> |
| |
| <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#ListQuery">ListQuery</a></dd> |
| <dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd> |
| <dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Data descriptors defined here:<br> |
| <dl><dt><strong>orderby</strong></dt> |
| <dd><tt>The orderby query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>reverse</strong></dt> |
| <dd><tt>The reverse query parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>sq</strong></dt> |
| <dd><tt>The sq query parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><a name="ListQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="ListQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br> |
| <br> |
| Args:<br> |
| feed: str (optional) The path for the feed (Examples: <br> |
| '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br> |
| text_query: str (optional) The contents of the q query parameter. The<br> |
| contents of the text_query are URL escaped upon conversion to a URI.<br> |
| params: dict (optional) Parameter value string pairs which become URL<br> |
| params when translated to a URI. These parameters are added to the<br> |
| query's items (key-value pairs).<br> |
| categories: list (optional) List of category strings which should be<br> |
| included as query categories. See <br> |
| <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br> |
| details. If you want to get results from category A or B (both <br> |
| categories), specify a single list item 'A|B'.</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>alt</strong></dt> |
| <dd><tt>The feed query's alt parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>author</strong></dt> |
| <dd><tt>The feed query's author parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>max_results</strong></dt> |
| <dd><tt>The feed query's max-results parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_max</strong></dt> |
| <dd><tt>The feed query's published-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>published_min</strong></dt> |
| <dd><tt>The feed query's published-min parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>start_index</strong></dt> |
| <dd><tt>The feed query's start-index parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>text_query</strong></dt> |
| <dd><tt>The feed query's q parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_max</strong></dt> |
| <dd><tt>The feed query's updated-max parameter</tt></dd> |
| </dl> |
| <dl><dt><strong>updated_min</strong></dt> |
| <dd><tt>The feed query's updated-min parameter</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><a name="ListQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#ListQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br> |
| v defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br> |
| If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br> |
| 2-tuple; but raise KeyError if D is empty.</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#ListQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br> |
| If E present and has a .<a href="#ListQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br> |
| If E present and lacks .<a href="#ListQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br> |
| In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-values">values</a>() -> list of D's values</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl> |
| |
| <dl><dt><a name="ListQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl> |
| |
| <hr> |
| Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br> |
| <dl><dt><strong>__hash__</strong> = None</dl> |
| |
| <dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ListQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
| |
| </td></tr></table> <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.spreadsheet.service.html#Error">Error</a>)</font></td></tr> |
| |
| <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#RequestError">RequestError</a></dd> |
| <dd><a href="gdata.spreadsheet.service.html#Error">Error</a></dd> |
| <dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> |
| <dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Data descriptors inherited from <a href="gdata.spreadsheet.service.html#Error">Error</a>:<br> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <hr> |
| Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
| <dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl> |
| |
| <hr> |
| Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> |
| <dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl> |
| |
| <hr> |
| Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
| <dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> |
| <br> |
| Use of negative indices is not supported.</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> |
| |
| <dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> |
| |
| <dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl> |
| |
| <dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| </dl> |
| <dl><dt><strong>args</strong></dt> |
| </dl> |
| <dl><dt><strong>message</strong></dt> |
| </dl> |
| </td></tr></table> <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="SpreadsheetsService">class <strong>SpreadsheetsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr> |
| |
| <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> |
| <td colspan=2><tt>Client for the Google Spreadsheets service.<br> </tt></td></tr> |
| <tr><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="gdata.spreadsheet.service.html#SpreadsheetsService">SpreadsheetsService</a></dd> |
| <dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd> |
| <dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Methods defined here:<br> |
| <dl><dt><a name="SpreadsheetsService-AddWorksheet"><strong>AddWorksheet</strong></a>(self, title, row_count, col_count, key)</dt><dd><tt>Creates a new worksheet in the desired spreadsheet.<br> |
| <br> |
| The new worksheet is appended to the end of the list of worksheets. The<br> |
| new worksheet will only have the available number of columns and cells <br> |
| specified.<br> |
| <br> |
| Args:<br> |
| title: str The title which will be displayed in the list of worksheets.<br> |
| row_count: int or str The number of rows in the new worksheet.<br> |
| col_count: int or str The number of columns in the new worksheet.<br> |
| key: str The spreadsheet key to the spreadsheet to which the new <br> |
| worksheet should be added. <br> |
| <br> |
| Returns:<br> |
| A SpreadsheetsWorksheet if the new worksheet was created succesfully.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-DeleteRow"><strong>DeleteRow</strong></a>(self, entry)</dt><dd><tt>Deletes a row, the provided entry<br> |
| <br> |
| Args:<br> |
| entry: gdata.spreadsheet.SpreadsheetsList The row to be deleted<br> |
| <br> |
| Returns:<br> |
| The delete response</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-DeleteWorksheet"><strong>DeleteWorksheet</strong></a>(self, worksheet_entry<font color="#909090">=None</font>, url<font color="#909090">=None</font>)</dt><dd><tt>Removes the desired worksheet from the spreadsheet<br> |
| <br> |
| Args:<br> |
| worksheet_entry: SpreadsheetWorksheet (optional) The worksheet to<br> |
| be deleted. If this is none, then the DELETE reqest is sent to <br> |
| the url specified in the url parameter.<br> |
| url: str (optaional) The URL to which the DELETE request should be<br> |
| sent. If left as None, the worksheet's edit URL is used.<br> |
| <br> |
| Returns:<br> |
| True if the worksheet was deleted successfully.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-ExecuteBatch"><strong>ExecuteBatch</strong></a>(self, batch_feed, url<font color="#909090">=None</font>, spreadsheet_key<font color="#909090">=None</font>, worksheet_id<font color="#909090">=None</font>, converter<font color="#909090">=<function SpreadsheetsCellsFeedFromString></font>)</dt><dd><tt>Sends a batch request feed to the server.<br> |
| <br> |
| The batch request needs to be sent to the batch URL for a particular <br> |
| worksheet. You can specify the worksheet by providing the spreadsheet_key<br> |
| and worksheet_id, or by sending the URL from the cells feed's batch link.<br> |
| <br> |
| Args:<br> |
| batch_feed: gdata.spreadsheet.SpreadsheetsCellFeed A feed containing <br> |
| BatchEntry elements which contain the desired CRUD operation and <br> |
| any necessary data to modify a cell.<br> |
| url: str (optional) The batch URL for the cells feed to which these <br> |
| changes should be applied. This can be found by calling <br> |
| cells_feed.GetBatchLink().href.<br> |
| spreadsheet_key: str (optional) Used to generate the batch request URL<br> |
| if the url argument is None. If using the spreadsheet key to <br> |
| generate the URL, the worksheet id is also required.<br> |
| worksheet_id: str (optional) Used if the url is not provided, it is <br> |
| oart of the batch feed target URL. This is used with the spreadsheet<br> |
| key.<br> |
| converter: Function (optional) Function to be executed on the server's<br> |
| response. This function should take one string as a parameter. The<br> |
| default value is SpreadsheetsCellsFeedFromString which will turn the result<br> |
| into a gdata.spreadsheet.SpreadsheetsCellsFeed object.<br> |
| <br> |
| Returns:<br> |
| A gdata.BatchFeed containing the results.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetCellsFeed"><strong>GetCellsFeed</strong></a>(self, key, wksht_id<font color="#909090">='default'</font>, cell<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a cells feed or a specific entry if a cell is defined<br> |
| Args:<br> |
| key: string The spreadsheet key defined in /ccc?key=<br> |
| wksht_id: string The id for a specific worksheet entry<br> |
| cell: string (optional) The R1C1 address of the cell<br> |
| query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br> |
| <br> |
| Returns:<br> |
| If there is no cell, then a SpreadsheetsCellsFeed.<br> |
| If there is a cell, then a SpreadsheetsCell.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetListFeed"><strong>GetListFeed</strong></a>(self, key, wksht_id<font color="#909090">='default'</font>, row_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a list feed or a specific entry if a row_id is defined<br> |
| Args:<br> |
| key: string The spreadsheet key defined in /ccc?key=<br> |
| wksht_id: string The id for a specific worksheet entry<br> |
| row_id: string (optional) The row_id of a row in the list<br> |
| query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br> |
| <br> |
| Returns:<br> |
| If there is no row_id, then a SpreadsheetsListFeed.<br> |
| If there is a row_id, then a SpreadsheetsList.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetSpreadsheetsFeed"><strong>GetSpreadsheetsFeed</strong></a>(self, key<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a spreadsheets feed or a specific entry if a key is defined<br> |
| Args:<br> |
| key: string (optional) The spreadsheet key defined in /ccc?key=<br> |
| query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br> |
| <br> |
| Returns:<br> |
| If there is no key, then a SpreadsheetsSpreadsheetsFeed.<br> |
| If there is a key, then a SpreadsheetsSpreadsheet.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetWorksheetsFeed"><strong>GetWorksheetsFeed</strong></a>(self, key, wksht_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a worksheets feed or a specific entry if a wksht is defined<br> |
| Args:<br> |
| key: string The spreadsheet key defined in /ccc?key=<br> |
| wksht_id: string (optional) The id for a specific worksheet entry<br> |
| query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br> |
| <br> |
| Returns:<br> |
| If there is no wksht_id, then a SpreadsheetsWorksheetsFeed.<br> |
| If there is a wksht_id, then a SpreadsheetsWorksheet.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-InsertRow"><strong>InsertRow</strong></a>(self, row_data, key, wksht_id<font color="#909090">='default'</font>)</dt><dd><tt>Inserts a new row with the provided data<br> |
| <br> |
| Args:<br> |
| uri: string The post uri of the list feed<br> |
| row_data: dict A dictionary of column header to row data<br> |
| <br> |
| Returns:<br> |
| The inserted row</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-UpdateCell"><strong>UpdateCell</strong></a>(self, row, col, inputValue, key, wksht_id<font color="#909090">='default'</font>)</dt><dd><tt>Updates an existing cell.<br> |
| <br> |
| Args:<br> |
| row: int The row the cell to be editted is in<br> |
| col: int The column the cell to be editted is in<br> |
| inputValue: str the new value of the cell<br> |
| key: str The key of the spreadsheet in which this cell resides.<br> |
| wksht_id: str The ID of the worksheet which holds this cell.<br> |
| <br> |
| Returns:<br> |
| The updated cell entry</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-UpdateRow"><strong>UpdateRow</strong></a>(self, entry, new_row_data)</dt><dd><tt>Updates a row with the provided data<br> |
| <br> |
| If you want to add additional information to a row, it is often<br> |
| easier to change the values in entry.custom, then use the Put<br> |
| method instead of UpdateRow. This UpdateRow method will replace<br> |
| the contents of the row with new_row_data - it will change all columns<br> |
| not just the columns specified in the new_row_data dict.<br> |
| <br> |
| Args:<br> |
| entry: gdata.spreadsheet.SpreadsheetsList The entry to be updated<br> |
| new_row_data: dict A dictionary of column header to row data<br> |
| <br> |
| Returns:<br> |
| The updated row</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-UpdateWorksheet"><strong>UpdateWorksheet</strong></a>(self, worksheet_entry, url<font color="#909090">=None</font>)</dt><dd><tt>Changes the size and/or title of the desired worksheet.<br> |
| <br> |
| Args:<br> |
| worksheet_entry: SpreadsheetWorksheet The new contents of the <br> |
| worksheet. <br> |
| url: str (optional) The URL to which the edited worksheet entry should<br> |
| be sent. If the url is None, the edit URL from the worksheet will<br> |
| be used.<br> |
| <br> |
| Returns: <br> |
| A SpreadsheetsWorksheet with the new information about the worksheet.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='spreadsheets.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Spreadsheets service.<br> |
| <br> |
| Args:<br> |
| email: string (optional) The user's email address, used for<br> |
| authentication.<br> |
| password: string (optional) The user's password.<br> |
| source: string (optional) The name of the user's application.<br> |
| server: string (optional) The name of the server to which a connection<br> |
| will be opened. Default value: 'spreadsheets.google.com'.<br> |
| **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br> |
| constructor.</tt></dd></dl> |
| |
| <hr> |
| Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br> |
| <dl><dt><a name="SpreadsheetsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br> |
| <br> |
| Raises:<br> |
| NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br> |
| <br> |
| Sets values for email, password, and other optional members.<br> |
| <br> |
| Args:<br> |
| username:<br> |
| password:<br> |
| account_type: string (optional)<br> |
| service: string (optional)<br> |
| auth_service_url: string (optional)<br> |
| captcha_token: string (optional)<br> |
| captcha_response: string (optional)</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br> |
| <br> |
| Args:<br> |
| uri: string The URI of the entry to be deleted. Example: <br> |
| '/base/feeds/items/ITEM-ID'<br> |
| extra_headers: dict (optional) HTTP headers which are to be included.<br> |
| The client automatically sets the Content-Type and<br> |
| Authorization headers.<br> |
| url_params: dict (optional) Additional URL parameters to be included<br> |
| in the URI. These are translated into query arguments<br> |
| in the form '&dict_key=value&...'.<br> |
| Example: {'max-results': '250'} becomes &max-results=250<br> |
| escape_params: boolean (optional) If false, the calling code has already<br> |
| ensured that the query will form a valid URL (all<br> |
| reserved characters have been escaped). If true, this<br> |
| method will escape the query and any URL parameters<br> |
| provided.<br> |
| <br> |
| Returns:<br> |
| True if the entry was deleted.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br> |
| <br> |
| Args:<br> |
| scopes: string or list of string base URL(s) of the service(s) to be<br> |
| accessed. If None, then this method tries to determine the<br> |
| scope(s) from the current service.<br> |
| extra_parameters: dict (optional) key-value pairs as any additional<br> |
| parameters to be included in the URL and signature while making a<br> |
| request for fetching an OAuth request token. All the OAuth parameters<br> |
| are added by default. But if provided through this argument, any<br> |
| default parameters will be overwritten. For e.g. a default parameter<br> |
| oauth_version 1.0 can be overwritten if<br> |
| extra_parameters = {'oauth_version': '2.0'}<br> |
| request_url: Request token URL. The default is<br> |
| 'https://www.google.com/accounts/OAuthGetRequestToken'.<br> |
| oauth_callback: str (optional) If set, it is assume the client is using<br> |
| the OAuth v1.0a protocol where the callback url is sent in the<br> |
| request token step. If the oauth_callback is also set in<br> |
| extra_params, this value will override that one.<br> |
| <br> |
| Returns:<br> |
| The fetched request token as a gdata.auth.OAuthToken object.<br> |
| <br> |
| Raises:<br> |
| FetchingOAuthRequestTokenFailed if the server responded to the request<br> |
| with an error.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br> |
| <br> |
| Users enter their credentials on a Google login page and a token is sent<br> |
| to the URL specified in next. See documentation for AuthSub login at:<br> |
| <a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br> |
| <br> |
| Args:<br> |
| next: string The URL user will be sent to after logging in.<br> |
| scope: string or list of strings. The URLs of the services to be <br> |
| accessed.<br> |
| secure: boolean (optional) Determines whether or not the issued token<br> |
| is a secure token.<br> |
| session: boolean (optional) Determines whether or not the issued token<br> |
| can be upgraded to a session token.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br> |
| <br> |
| Args:<br> |
| request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br> |
| If not specified, then the current token will be used if it is of<br> |
| type <gdata.auth.OAuthToken>, else it is found by looking in the<br> |
| token_store by looking for a token for the current scope. <br> |
| callback_url: string (optional) The URL user will be sent to after<br> |
| logging in and granting access.<br> |
| extra_params: dict (optional) Additional parameters to be sent.<br> |
| include_scopes_in_callback: Boolean (default=False) if set to True, and<br> |
| if 'callback_url' is present, the 'callback_url' will be modified to<br> |
| include the scope(s) from the request token as a URL parameter. The<br> |
| key for the 'callback' URL's scope parameter will be<br> |
| OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br> |
| a parameter to the 'callback' URL, is that the page which receives<br> |
| the OAuth token will be able to tell which URLs the token grants<br> |
| access to.<br> |
| scopes_param_prefix: string (default='oauth_token_scope') The URL<br> |
| parameter key which maps to the list of valid scopes for the token.<br> |
| This URL parameter will be included in the callback URL along with<br> |
| the scopes of the token as value if include_scopes_in_callback=True.<br> |
| request_url: Authorization URL. The default is<br> |
| 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br> |
| Returns:<br> |
| A string URL at which the user is required to login.<br> |
| <br> |
| Raises:<br> |
| NonOAuthToken if the user's request token is not an OAuth token or if a<br> |
| request token was not available.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br> |
| <br> |
| The uri is the portion of the URI after the server value <br> |
| (ex: www.google.com).<br> |
| <br> |
| To perform a query against Google Base, set the server to <br> |
| 'base.google.com' and set the uri to '/base/feeds/...', where ... is <br> |
| your query. For example, to find snippets for all digital cameras uri <br> |
| should be set to: '/base/feeds/snippets?bq=digital+camera'<br> |
| <br> |
| Args:<br> |
| uri: string The query in the form of a URI. Example:<br> |
| '/base/feeds/snippets?bq=digital+camera'.<br> |
| extra_headers: dictionary (optional) Extra HTTP headers to be included<br> |
| in the GET request. These headers are in addition to <br> |
| those stored in the client's additional_headers property.<br> |
| The client automatically sets the Content-Type and <br> |
| Authorization headers.<br> |
| redirects_remaining: int (optional) Tracks the number of additional<br> |
| redirects this method will allow. If the service object receives<br> |
| a redirect and remaining is 0, it will not follow the redirect. <br> |
| This was added to avoid infinite redirect loops.<br> |
| encoding: string (optional) The character encoding for the server's<br> |
| response. Default is UTF-8<br> |
| converter: func (optional) A function which will transform<br> |
| the server's results before it is returned. Example: use <br> |
| GDataFeedFromString to parse the server response as if it<br> |
| were a GDataFeed.<br> |
| <br> |
| Returns:<br> |
| If there is no ResultsTransformer specified in the call, a GDataFeed <br> |
| or GDataEntry depending on which is sent from the server. If the <br> |
| response is niether a feed or entry and there is no ResultsTransformer,<br> |
| return a string. If there is a ResultsTransformer, the returned value <br> |
| will be that of the ResultsTransformer function.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br> |
| <br> |
| If the token is an gdta.auth.AuthSubToken, the Authorization Label<br> |
| ("AuthSub token") is removed.<br> |
| <br> |
| This method examines the current_token to see if it is an AuthSubToken<br> |
| or SecureAuthSubToken. If not, it searches the token_store for a token<br> |
| which matches the current scope.<br> |
| <br> |
| The current scope is determined by the service name string member.<br> |
| <br> |
| Returns:<br> |
| If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br> |
| return the token string. If there is no current_token, a token string<br> |
| for a token which matches the service object's default scope is returned.<br> |
| If there are no tokens valid for the scope, returns None.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br> |
| service scope.<br> |
| <br> |
| If the current_token is a ClientLoginToken, the token string for <br> |
| the current token is returned. If the current_token is not set, this method<br> |
| searches for a token in the token_store which is valid for the service <br> |
| object's current scope.<br> |
| <br> |
| The current scope is determined by the service name string member.<br> |
| The token string is the end of the Authorization header, it doesn not<br> |
| include the ClientLogin label.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br> |
| <br> |
| See also documentation for gdata.service.Get<br> |
| <br> |
| Args:<br> |
| uri: string The query in the form of a URI. Example:<br> |
| '/base/feeds/snippets?bq=digital+camera'.<br> |
| extra_headers: dictionary (optional) Extra HTTP headers to be included<br> |
| in the GET request. These headers are in addition to<br> |
| those stored in the client's additional_headers property.<br> |
| The client automatically sets the Content-Type and<br> |
| Authorization headers.<br> |
| <br> |
| Returns:<br> |
| A GDataEntry built from the XML in the server's response.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br> |
| <br> |
| See also documentation for gdata.service.Get<br> |
| <br> |
| Args:<br> |
| uri: string The query in the form of a URI. Example:<br> |
| '/base/feeds/snippets?bq=digital+camera'.<br> |
| extra_headers: dictionary (optional) Extra HTTP headers to be included<br> |
| in the GET request. These headers are in addition to<br> |
| those stored in the client's additional_headers property.<br> |
| The client automatically sets the Content-Type and<br> |
| Authorization headers.<br> |
| <br> |
| Returns:<br> |
| A GDataFeed built from the XML in the server's response.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br> |
| URI string.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br> |
| <br> |
| This method uses the feed's next link to request an additional feed<br> |
| and uses the class of the feed to convert the results of the GET request.<br> |
| <br> |
| Args:<br> |
| feed: atom.Feed or a subclass. The feed should contain a next link and<br> |
| the type of the feed will be applied to the results from the <br> |
| server. The new feed which is returned will be of the same class<br> |
| as this feed which was passed in.<br> |
| <br> |
| Returns:<br> |
| A new feed representing the next set of results in the server's feed.<br> |
| The type of this feed will match that of the feed argument.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br> |
| <br> |
| To avoid various errors while retrieving bulk entities by retrying<br> |
| specified times.<br> |
| <br> |
| Note this method relies on the time module and so may not be usable<br> |
| by default in Python2.2.<br> |
| <br> |
| Args:<br> |
| num_retries: Integer; the retry count.<br> |
| delay: Integer; the initial delay for retrying.<br> |
| backoff: Integer; how much the delay should lengthen after each failure.<br> |
| logger: An object which has a <a href="#SpreadsheetsService-debug">debug</a>(str) method to receive logging<br> |
| messages. Recommended that you pass in the logging module.<br> |
| Raises:<br> |
| ValueError if any of the parameters has an invalid value.<br> |
| RanOutOfTries on failure after number of retries.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br> |
| <br> |
| Args:<br> |
| data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br> |
| XML to be sent to the uri.<br> |
| uri: string The location (feed) to which the data should be inserted.<br> |
| Example: '/base/feeds/items'.<br> |
| extra_headers: dict (optional) HTTP headers which are to be included.<br> |
| The client automatically sets the Content-Type,<br> |
| Authorization, and Content-Length headers.<br> |
| url_params: dict (optional) Additional URL parameters to be included<br> |
| in the URI. These are translated into query arguments<br> |
| in the form '&dict_key=value&...'.<br> |
| Example: {'max-results': '250'} becomes &max-results=250<br> |
| escape_params: boolean (optional) If false, the calling code has already<br> |
| ensured that the query will form a valid URL (all<br> |
| reserved characters have been escaped). If true, this<br> |
| method will escape the query and any URL parameters<br> |
| provided.<br> |
| media_source: MediaSource (optional) Container for the media to be sent<br> |
| along with the entry, if provided.<br> |
| converter: func (optional) A function which will be executed on the<br> |
| server's response. Often this is a function like<br> |
| GDataEntryFromString which will parse the body of the server's<br> |
| response and return a GDataEntry.<br> |
| <br> |
| Returns:<br> |
| If the post succeeded, this method will return a GDataFeed, GDataEntry,<br> |
| or the results of running converter on the server's result body (if<br> |
| converter was specified).</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br> |
| <br> |
| Args:<br> |
| verb: string, either 'POST' or 'PUT'<br> |
| data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br> |
| XML to be sent to the uri. <br> |
| uri: string The location (feed) to which the data should be inserted. <br> |
| Example: '/base/feeds/items'. <br> |
| extra_headers: dict (optional) HTTP headers which are to be included. <br> |
| The client automatically sets the Content-Type,<br> |
| Authorization, and Content-Length headers.<br> |
| url_params: dict (optional) Additional URL parameters to be included<br> |
| in the URI. These are translated into query arguments<br> |
| in the form '&dict_key=value&...'.<br> |
| Example: {'max-results': '250'} becomes &max-results=250<br> |
| escape_params: boolean (optional) If false, the calling code has already<br> |
| ensured that the query will form a valid URL (all<br> |
| reserved characters have been escaped). If true, this<br> |
| method will escape the query and any URL parameters<br> |
| provided.<br> |
| media_source: MediaSource (optional) Container for the media to be sent<br> |
| along with the entry, if provided.<br> |
| converter: func (optional) A function which will be executed on the <br> |
| server's response. Often this is a function like <br> |
| GDataEntryFromString which will parse the body of the server's <br> |
| response and return a GDataEntry.<br> |
| <br> |
| Returns:<br> |
| If the post succeeded, this method will return a GDataFeed, GDataEntry,<br> |
| or the results of running converter on the server's result body (if<br> |
| converter was specified).</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br> |
| <br> |
| Login retreives a temporary auth token which must be used with all<br> |
| requests to GData services. The auth token is stored in the GData client<br> |
| object.<br> |
| <br> |
| Login is also used to respond to a captcha challenge. If the user's login<br> |
| attempt failed with a CaptchaRequired error, the user can respond by<br> |
| calling Login with the captcha token and the answer to the challenge.<br> |
| <br> |
| Args:<br> |
| captcha_token: string (optional) The identifier for the captcha challenge<br> |
| which was presented to the user.<br> |
| captcha_response: string (optional) The user's answer to the captch <br> |
| challenge.<br> |
| <br> |
| Raises:<br> |
| CaptchaRequired if the login service will require a captcha response<br> |
| BadAuthentication if the login service rejected the username or password<br> |
| <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br> |
| <br> |
| Args:<br> |
| data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br> |
| XML containing the updated data.<br> |
| uri: string A URI indicating entry to which the update will be applied.<br> |
| Example: '/base/feeds/items/ITEM-ID'<br> |
| extra_headers: dict (optional) HTTP headers which are to be included.<br> |
| The client automatically sets the Content-Type,<br> |
| Authorization, and Content-Length headers.<br> |
| url_params: dict (optional) Additional URL parameters to be included<br> |
| in the URI. These are translated into query arguments<br> |
| in the form '&dict_key=value&...'.<br> |
| Example: {'max-results': '250'} becomes &max-results=250<br> |
| escape_params: boolean (optional) If false, the calling code has already<br> |
| ensured that the query will form a valid URL (all<br> |
| reserved characters have been escaped). If true, this<br> |
| method will escape the query and any URL parameters<br> |
| provided.<br> |
| converter: func (optional) A function which will be executed on the <br> |
| server's response. Often this is a function like <br> |
| GDataEntryFromString which will parse the body of the server's <br> |
| response and return a GDataEntry.<br> |
| <br> |
| Returns:<br> |
| If the put succeeded, this method will return a GDataFeed, GDataEntry,<br> |
| or the results of running converter on the server's result body (if<br> |
| converter was specified).</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br> |
| <br> |
| Raises:<br> |
| NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br> |
| <br> |
| request_url: Token revoke URL. The default is<br> |
| 'https://www.google.com/accounts/AuthSubRevokeToken'.<br> |
| Raises:<br> |
| NonOAuthToken if the user's auth token is not an OAuth token.<br> |
| RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br> |
| <br> |
| Sets the current_token and attempts to add the token to the token_store.<br> |
| <br> |
| Only use this method if you have received a token from the AuthSub<br> |
| service. The auth token is set automatically when <a href="#SpreadsheetsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br> |
| is used. See documentation for Google AuthSub here:<br> |
| <a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br> |
| <br> |
| Args:<br> |
| token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br> |
| The token returned by the AuthSub service. If the token is an<br> |
| AuthSubToken or SecureAuthSubToken, the scope information stored in<br> |
| the token is used. If the token is a string, the scopes parameter is<br> |
| used to determine the valid scopes.<br> |
| scopes: list of URLs for which the token is valid. This is only used<br> |
| if the token parameter is a string.<br> |
| rsa_key: string (optional) Private key required for RSA_SHA1 signature<br> |
| method. This parameter is necessary if the token is a string<br> |
| representing a secure token.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br> |
| <br> |
| This method sets the current_token to a new ClientLoginToken and it <br> |
| also attempts to add the ClientLoginToken to the token_store.<br> |
| <br> |
| Only use this method if you have received a token from the ClientLogin<br> |
| service. The auth_token is set automatically when <a href="#SpreadsheetsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br> |
| is used. See documentation for Google ClientLogin here:<br> |
| <a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br> |
| <br> |
| Args:<br> |
| token: string or instance of a ClientLoginToken.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br> |
| <br> |
| NOTE: Though consumer_secret and rsa_key are optional, either of the two<br> |
| is required depending on the value of the signature_method.<br> |
| <br> |
| Args:<br> |
| signature_method: class which provides implementation for strategy class<br> |
| oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br> |
| signing each request. Valid implementations are provided as the<br> |
| constants defined by gdata.auth.OAuthSignatureMethod. Currently<br> |
| they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br> |
| gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br> |
| consumer_key: string Domain identifying third_party web application.<br> |
| consumer_secret: string (optional) Secret generated during registration.<br> |
| Required only for HMAC_SHA1 signature method.<br> |
| rsa_key: string (optional) Private key required for RSA_SHA1 signature<br> |
| method.<br> |
| two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br> |
| requestor_id: string (optional) User email adress to make requests on<br> |
| their behalf. This parameter should only be set when two_legged_oauth<br> |
| is True.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br> |
| <br> |
| The oauth_token can be any OAuth token i.e. unauthorized request token,<br> |
| authorized request token or access token.<br> |
| This method also attempts to add the token to the token store.<br> |
| Use this method any time you want the current token to point to the<br> |
| oauth_token passed. For e.g. call this method with the request token<br> |
| you receive from FetchOAuthRequestToken.<br> |
| <br> |
| Args:<br> |
| request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br> |
| <br> |
| Args:<br> |
| authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br> |
| token. If not specified, then the current token will be used if it is<br> |
| of type <gdata.auth.OAuthToken>, else it is found by looking in the<br> |
| token_store by looking for a token for the current scope.<br> |
| request_url: Access token URL. The default is<br> |
| 'https://www.google.com/accounts/OAuthGetAccessToken'.<br> |
| oauth_version: str (default='1.0') oauth_version parameter. All other<br> |
| 'oauth_' parameters are added by default. This parameter too, is<br> |
| added by default but here you can override it's value.<br> |
| oauth_verifier: str (optional) If present, it is assumed that the client<br> |
| will use the OAuth v1.0a protocol which includes passing the<br> |
| oauth_verifier (as returned by the SP) in the access token step.<br> |
| <br> |
| Returns:<br> |
| Access token<br> |
| <br> |
| Raises:<br> |
| NonOAuthToken if the user's authorized request token is not an OAuth<br> |
| token or if an authorized request token was not available.<br> |
| TokenUpgradeFailed if the server responded to the request with an <br> |
| error.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br> |
| <br> |
| Args:<br> |
| token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br> |
| (optional) which is good for a single use but can be upgraded<br> |
| to a session token. If no token is passed in, the token<br> |
| is found by looking in the token_store by looking for a token<br> |
| for the current scope.<br> |
| <br> |
| Raises:<br> |
| NonAuthSubToken if the user's auth token is not an AuthSub token<br> |
| TokenUpgradeFailed if the server responded to the request with an <br> |
| error.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br> |
| <br> |
| Args:<br> |
| token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br> |
| which is good for a single use but can be upgraded to a<br> |
| session token.<br> |
| <br> |
| Returns:<br> |
| The upgraded token as a gdata.auth.AuthSubToken object.<br> |
| <br> |
| Raises:<br> |
| TokenUpgradeFailed if the server responded to the request with an <br> |
| error.</tt></dd></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br> |
| <dl><dt><strong>captcha_token</strong></dt> |
| <dd><tt>Get the captcha token for a login request.</tt></dd> |
| </dl> |
| <dl><dt><strong>captcha_url</strong></dt> |
| <dd><tt>Get the captcha URL for a login request.</tt></dd> |
| </dl> |
| <dl><dt><strong>source</strong></dt> |
| <dd><tt>The source is the name of the application making the request. <br> |
| It should be in the form company_id-app_name-app_version</tt></dd> |
| </dl> |
| <hr> |
| Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br> |
| <dl><dt><strong>auth_token</strong> = None</dl> |
| |
| <dl><dt><strong>handler</strong> = None</dl> |
| |
| <dl><dt><strong>tokens</strong> = None</dl> |
| |
| <hr> |
| Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br> |
| <dl><dt><a name="SpreadsheetsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br> |
| <br> |
| Deprecated, use use_basic_auth instead.<br> |
| <br> |
| The username and password are base64 encoded and added to an HTTP header<br> |
| which will be included in each request. Note that your username and <br> |
| password are sent in plaintext.<br> |
| <br> |
| Args:<br> |
| username: str<br> |
| password: str</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl> |
| |
| <dl><dt><a name="SpreadsheetsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>debug</strong></dt> |
| <dd><tt>If True, HTTP debug information is printed.</tt></dd> |
| </dl> |
| <dl><dt><strong>override_token</strong></dt> |
| </dl> |
| <hr> |
| Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br> |
| <dl><dt><strong>auto_set_current_token</strong> = True</dl> |
| |
| <dl><dt><strong>auto_store_tokens</strong> = True</dl> |
| |
| <dl><dt><strong>current_token</strong> = None</dl> |
| |
| <dl><dt><strong>port</strong> = 80</dl> |
| |
| <dl><dt><strong>ssl</strong> = False</dl> |
| |
| </td></tr></table></td></tr></table><p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#55aa55"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td> |
| <td width="100%"><strong>__author__</strong> = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'</td></tr></table><p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#7799ee"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td> |
| <td width="100%">api.laurabeth@gmail.com (Laura Beth Lincoln)</td></tr></table> |
| </body></html> |
