Home | History | Annotate | Download | only in epy
      1 <?xml version="1.0" encoding="ascii"?>
      2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
      3           "DTD/xhtml1-transitional.dtd">
      4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
      5 <head>
      6   <title>googleapiclient.discovery.Resource</title>
      7   <link rel="stylesheet" href="epydoc.css" type="text/css" />
      8   <script type="text/javascript" src="epydoc.js"></script>
      9 </head>
     10 
     11 <body bgcolor="white" text="black" link="blue" vlink="#204080"
     12       alink="#204080">
     13 <!-- ==================== NAVIGATION BAR ==================== -->
     14 <table class="navbar" border="0" width="100%" cellpadding="0"
     15        bgcolor="#a0c0ff" cellspacing="0">
     16   <tr valign="middle">
     17   <!-- Home link -->
     18       <th>&nbsp;&nbsp;&nbsp;<a
     19         href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
     20 
     21   <!-- Tree link -->
     22       <th>&nbsp;&nbsp;&nbsp;<a
     23         href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
     24 
     25   <!-- Index link -->
     26       <th>&nbsp;&nbsp;&nbsp;<a
     27         href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
     28 
     29   <!-- Help link -->
     30       <th>&nbsp;&nbsp;&nbsp;<a
     31         href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
     32 
     33       <th class="navbar" width="100%"></th>
     34   </tr>
     35 </table>
     36 <table width="100%" cellpadding="0" cellspacing="0">
     37   <tr valign="top">
     38     <td width="100%">
     39       <span class="breadcrumbs">
     40         <a href="googleapiclient-module.html">Package&nbsp;googleapiclient</a> ::
     41         <a href="googleapiclient.discovery-module.html">Module&nbsp;discovery</a> ::
     42         Class&nbsp;Resource
     43       </span>
     44     </td>
     45     <td>
     46       <table cellpadding="0" cellspacing="0">
     47         <!-- hide/show private -->
     48         <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
     49     onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
     50         <tr><td align="right"><span class="options"
     51             >[<a href="frames.html" target="_top">frames</a
     52             >]&nbsp;|&nbsp;<a href="googleapiclient.discovery.Resource-class.html"
     53             target="_top">no&nbsp;frames</a>]</span></td></tr>
     54       </table>
     55     </td>
     56   </tr>
     57 </table>
     58 <!-- ==================== CLASS DESCRIPTION ==================== -->
     59 <h1 class="epydoc">Class Resource</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource">source&nbsp;code</a></span></p>
     60 <center>
     61 
     62 </center>
     63 <hr />
     64 <pre class="literalblock">
     65 A class for interacting with a resource.
     66 
     67 </pre>
     68 
     69 <!-- ==================== INSTANCE METHODS ==================== -->
     70 <a name="section-InstanceMethods"></a>
     71 <table class="summary" border="1" cellpadding="3"
     72        cellspacing="0" width="100%" bgcolor="white">
     73 <tr bgcolor="#70b0f0" class="table-header">
     74   <td colspan="2" class="table-header">
     75     <table border="0" cellpadding="0" cellspacing="0" width="100%">
     76       <tr valign="top">
     77         <td align="left"><span class="table-header">Instance Methods</span></td>
     78         <td align="right" valign="top"
     79          ><span class="options">[<a href="#section-InstanceMethods"
     80          class="privatelink" onclick="toggle_private();"
     81          >hide private</a>]</span></td>
     82       </tr>
     83     </table>
     84   </td>
     85 </tr>
     86 <tr>
     87     <td width="15%" align="right" valign="top" class="summary">
     88       <span class="summary-type">&nbsp;</span>
     89     </td><td class="summary">
     90       <table width="100%" cellpadding="0" cellspacing="0" border="0">
     91         <tr>
     92           <td><span class="summary-sig"><a href="googleapiclient.discovery.Resource-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
     93         <span class="summary-sig-arg">http</span>,
     94         <span class="summary-sig-arg">baseUrl</span>,
     95         <span class="summary-sig-arg">model</span>,
     96         <span class="summary-sig-arg">requestBuilder</span>,
     97         <span class="summary-sig-arg">developerKey</span>,
     98         <span class="summary-sig-arg">resourceDesc</span>,
     99         <span class="summary-sig-arg">rootDesc</span>,
    100         <span class="summary-sig-arg">schema</span>)</span><br />
    101       Build a Resource from the API description.</td>
    102           <td align="right" valign="top">
    103             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__init__">source&nbsp;code</a></span>
    104             
    105           </td>
    106         </tr>
    107       </table>
    108       
    109     </td>
    110   </tr>
    111 <tr class="private">
    112     <td width="15%" align="right" valign="top" class="summary">
    113       <span class="summary-type">&nbsp;</span>
    114     </td><td class="summary">
    115       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    116         <tr>
    117           <td><span class="summary-sig"><a href="googleapiclient.discovery.Resource-class.html#_set_dynamic_attr" class="summary-sig-name" onclick="show_private();">_set_dynamic_attr</a>(<span class="summary-sig-arg">self</span>,
    118         <span class="summary-sig-arg">attr_name</span>,
    119         <span class="summary-sig-arg">value</span>)</span><br />
    120       Sets an instance attribute and tracks it in a list of dynamic attributes.</td>
    121           <td align="right" valign="top">
    122             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._set_dynamic_attr">source&nbsp;code</a></span>
    123             
    124           </td>
    125         </tr>
    126       </table>
    127       
    128     </td>
    129   </tr>
    130 <tr>
    131     <td width="15%" align="right" valign="top" class="summary">
    132       <span class="summary-type">&nbsp;</span>
    133     </td><td class="summary">
    134       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    135         <tr>
    136           <td><span class="summary-sig"><a href="googleapiclient.discovery.Resource-class.html#__getstate__" class="summary-sig-name">__getstate__</a>(<span class="summary-sig-arg">self</span>)</span><br />
    137       Trim the state down to something that can be pickled.</td>
    138           <td align="right" valign="top">
    139             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__getstate__">source&nbsp;code</a></span>
    140             
    141           </td>
    142         </tr>
    143       </table>
    144       
    145     </td>
    146   </tr>
    147 <tr>
    148     <td width="15%" align="right" valign="top" class="summary">
    149       <span class="summary-type">&nbsp;</span>
    150     </td><td class="summary">
    151       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    152         <tr>
    153           <td><span class="summary-sig"><a href="googleapiclient.discovery.Resource-class.html#__setstate__" class="summary-sig-name">__setstate__</a>(<span class="summary-sig-arg">self</span>,
    154         <span class="summary-sig-arg">state</span>)</span><br />
    155       Reconstitute the state of the object from being pickled.</td>
    156           <td align="right" valign="top">
    157             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__setstate__">source&nbsp;code</a></span>
    158             
    159           </td>
    160         </tr>
    161       </table>
    162       
    163     </td>
    164   </tr>
    165 <tr class="private">
    166     <td width="15%" align="right" valign="top" class="summary">
    167       <span class="summary-type">&nbsp;</span>
    168     </td><td class="summary">
    169       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    170         <tr>
    171           <td><span class="summary-sig"><a name="_set_service_methods"></a><span class="summary-sig-name">_set_service_methods</span>(<span class="summary-sig-arg">self</span>)</span></td>
    172           <td align="right" valign="top">
    173             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._set_service_methods">source&nbsp;code</a></span>
    174             
    175           </td>
    176         </tr>
    177       </table>
    178       
    179     </td>
    180   </tr>
    181 <tr class="private">
    182     <td width="15%" align="right" valign="top" class="summary">
    183       <span class="summary-type">&nbsp;</span>
    184     </td><td class="summary">
    185       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    186         <tr>
    187           <td><span class="summary-sig"><a name="_add_basic_methods"></a><span class="summary-sig-name">_add_basic_methods</span>(<span class="summary-sig-arg">self</span>,
    188         <span class="summary-sig-arg">resourceDesc</span>,
    189         <span class="summary-sig-arg">rootDesc</span>,
    190         <span class="summary-sig-arg">schema</span>)</span></td>
    191           <td align="right" valign="top">
    192             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_basic_methods">source&nbsp;code</a></span>
    193             
    194           </td>
    195         </tr>
    196       </table>
    197       
    198     </td>
    199   </tr>
    200 <tr class="private">
    201     <td width="15%" align="right" valign="top" class="summary">
    202       <span class="summary-type">&nbsp;</span>
    203     </td><td class="summary">
    204       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    205         <tr>
    206           <td><span class="summary-sig"><a name="_add_nested_resources"></a><span class="summary-sig-name">_add_nested_resources</span>(<span class="summary-sig-arg">self</span>,
    207         <span class="summary-sig-arg">resourceDesc</span>,
    208         <span class="summary-sig-arg">rootDesc</span>,
    209         <span class="summary-sig-arg">schema</span>)</span></td>
    210           <td align="right" valign="top">
    211             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_nested_resources">source&nbsp;code</a></span>
    212             
    213           </td>
    214         </tr>
    215       </table>
    216       
    217     </td>
    218   </tr>
    219 <tr class="private">
    220     <td width="15%" align="right" valign="top" class="summary">
    221       <span class="summary-type">&nbsp;</span>
    222     </td><td class="summary">
    223       <table width="100%" cellpadding="0" cellspacing="0" border="0">
    224         <tr>
    225           <td><span class="summary-sig"><a name="_add_next_methods"></a><span class="summary-sig-name">_add_next_methods</span>(<span class="summary-sig-arg">self</span>,
    226         <span class="summary-sig-arg">resourceDesc</span>,
    227         <span class="summary-sig-arg">schema</span>)</span></td>
    228           <td align="right" valign="top">
    229             <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_next_methods">source&nbsp;code</a></span>
    230             
    231           </td>
    232         </tr>
    233       </table>
    234       
    235     </td>
    236   </tr>
    237   <tr>
    238     <td colspan="2" class="summary">
    239     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
    240       <code>__delattr__</code>,
    241       <code>__format__</code>,
    242       <code>__getattribute__</code>,
    243       <code>__hash__</code>,
    244       <code>__new__</code>,
    245       <code>__reduce__</code>,
    246       <code>__reduce_ex__</code>,
    247       <code>__repr__</code>,
    248       <code>__setattr__</code>,
    249       <code>__sizeof__</code>,
    250       <code>__str__</code>,
    251       <code>__subclasshook__</code>
    252       </p>
    253     </td>
    254   </tr>
    255 </table>
    256 <!-- ==================== PROPERTIES ==================== -->
    257 <a name="section-Properties"></a>
    258 <table class="summary" border="1" cellpadding="3"
    259        cellspacing="0" width="100%" bgcolor="white">
    260 <tr bgcolor="#70b0f0" class="table-header">
    261   <td colspan="2" class="table-header">
    262     <table border="0" cellpadding="0" cellspacing="0" width="100%">
    263       <tr valign="top">
    264         <td align="left"><span class="table-header">Properties</span></td>
    265         <td align="right" valign="top"
    266          ><span class="options">[<a href="#section-Properties"
    267          class="privatelink" onclick="toggle_private();"
    268          >hide private</a>]</span></td>
    269       </tr>
    270     </table>
    271   </td>
    272 </tr>
    273   <tr>
    274     <td colspan="2" class="summary">
    275     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
    276       <code>__class__</code>
    277       </p>
    278     </td>
    279   </tr>
    280 </table>
    281 <!-- ==================== METHOD DETAILS ==================== -->
    282 <a name="section-MethodDetails"></a>
    283 <table class="details" border="1" cellpadding="3"
    284        cellspacing="0" width="100%" bgcolor="white">
    285 <tr bgcolor="#70b0f0" class="table-header">
    286   <td colspan="2" class="table-header">
    287     <table border="0" cellpadding="0" cellspacing="0" width="100%">
    288       <tr valign="top">
    289         <td align="left"><span class="table-header">Method Details</span></td>
    290         <td align="right" valign="top"
    291          ><span class="options">[<a href="#section-MethodDetails"
    292          class="privatelink" onclick="toggle_private();"
    293          >hide private</a>]</span></td>
    294       </tr>
    295     </table>
    296   </td>
    297 </tr>
    298 </table>
    299 <a name="__init__"></a>
    300 <div>
    301 <table class="details" border="1" cellpadding="3"
    302        cellspacing="0" width="100%" bgcolor="white">
    303 <tr><td>
    304   <table width="100%" cellpadding="0" cellspacing="0" border="0">
    305   <tr valign="top"><td>
    306   <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
    307         <span class="sig-arg">http</span>,
    308         <span class="sig-arg">baseUrl</span>,
    309         <span class="sig-arg">model</span>,
    310         <span class="sig-arg">requestBuilder</span>,
    311         <span class="sig-arg">developerKey</span>,
    312         <span class="sig-arg">resourceDesc</span>,
    313         <span class="sig-arg">rootDesc</span>,
    314         <span class="sig-arg">schema</span>)</span>
    315     <br /><em class="fname">(Constructor)</em>
    316   </h3>
    317   </td><td align="right" valign="top"
    318     ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__init__">source&nbsp;code</a></span>&nbsp;
    319     </td>
    320   </tr></table>
    321   
    322   <pre class="literalblock">
    323 Build a Resource from the API description.
    324 
    325 Args:
    326   http: httplib2.Http, Object to make http requests with.
    327   baseUrl: string, base URL for the API. All requests are relative to this
    328       URI.
    329   model: googleapiclient.Model, converts to and from the wire format.
    330   requestBuilder: class or callable that instantiates an
    331       googleapiclient.HttpRequest object.
    332   developerKey: string, key obtained from
    333       https://code.google.com/apis/console
    334   resourceDesc: object, section of deserialized discovery document that
    335       describes a resource. Note that the top level discovery document
    336       is considered a resource.
    337   rootDesc: object, the entire deserialized discovery document.
    338   schema: object, mapping of schema names to schema descriptions.
    339 
    340 </pre>
    341   <dl class="fields">
    342     <dt>Overrides:
    343         object.__init__
    344     </dt>
    345   </dl>
    346 </td></tr></table>
    347 </div>
    348 <a name="_set_dynamic_attr"></a>
    349 <div class="private">
    350 <table class="details" border="1" cellpadding="3"
    351        cellspacing="0" width="100%" bgcolor="white">
    352 <tr><td>
    353   <table width="100%" cellpadding="0" cellspacing="0" border="0">
    354   <tr valign="top"><td>
    355   <h3 class="epydoc"><span class="sig"><span class="sig-name">_set_dynamic_attr</span>(<span class="sig-arg">self</span>,
    356         <span class="sig-arg">attr_name</span>,
    357         <span class="sig-arg">value</span>)</span>
    358   </h3>
    359   </td><td align="right" valign="top"
    360     ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._set_dynamic_attr">source&nbsp;code</a></span>&nbsp;
    361     </td>
    362   </tr></table>
    363   
    364   <pre class="literalblock">
    365 Sets an instance attribute and tracks it in a list of dynamic attributes.
    366 
    367 Args:
    368   attr_name: string; The name of the attribute to be set
    369   value: The value being set on the object and tracked in the dynamic cache.
    370 
    371 </pre>
    372   <dl class="fields">
    373   </dl>
    374 </td></tr></table>
    375 </div>
    376 <a name="__getstate__"></a>
    377 <div>
    378 <table class="details" border="1" cellpadding="3"
    379        cellspacing="0" width="100%" bgcolor="white">
    380 <tr><td>
    381   <table width="100%" cellpadding="0" cellspacing="0" border="0">
    382   <tr valign="top"><td>
    383   <h3 class="epydoc"><span class="sig"><span class="sig-name">__getstate__</span>(<span class="sig-arg">self</span>)</span>
    384   </h3>
    385   </td><td align="right" valign="top"
    386     ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__getstate__">source&nbsp;code</a></span>&nbsp;
    387     </td>
    388   </tr></table>
    389   
    390   <pre class="literalblock">
    391 Trim the state down to something that can be pickled.
    392 
    393 Uses the fact that the instance variable _dynamic_attrs holds attrs that
    394 will be wiped and restored on pickle serialization.
    395 
    396 </pre>
    397   <dl class="fields">
    398   </dl>
    399 </td></tr></table>
    400 </div>
    401 <a name="__setstate__"></a>
    402 <div>
    403 <table class="details" border="1" cellpadding="3"
    404        cellspacing="0" width="100%" bgcolor="white">
    405 <tr><td>
    406   <table width="100%" cellpadding="0" cellspacing="0" border="0">
    407   <tr valign="top"><td>
    408   <h3 class="epydoc"><span class="sig"><span class="sig-name">__setstate__</span>(<span class="sig-arg">self</span>,
    409         <span class="sig-arg">state</span>)</span>
    410   </h3>
    411   </td><td align="right" valign="top"
    412     ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__setstate__">source&nbsp;code</a></span>&nbsp;
    413     </td>
    414   </tr></table>
    415   
    416   <pre class="literalblock">
    417 Reconstitute the state of the object from being pickled.
    418 
    419 Uses the fact that the instance variable _dynamic_attrs holds attrs that
    420 will be wiped and restored on pickle serialization.
    421 
    422 </pre>
    423   <dl class="fields">
    424   </dl>
    425 </td></tr></table>
    426 </div>
    427 <br />
    428 <!-- ==================== NAVIGATION BAR ==================== -->
    429 <table class="navbar" border="0" width="100%" cellpadding="0"
    430        bgcolor="#a0c0ff" cellspacing="0">
    431   <tr valign="middle">
    432   <!-- Home link -->
    433       <th>&nbsp;&nbsp;&nbsp;<a
    434         href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
    435 
    436   <!-- Tree link -->
    437       <th>&nbsp;&nbsp;&nbsp;<a
    438         href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
    439 
    440   <!-- Index link -->
    441       <th>&nbsp;&nbsp;&nbsp;<a
    442         href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
    443 
    444   <!-- Help link -->
    445       <th>&nbsp;&nbsp;&nbsp;<a
    446         href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
    447 
    448       <th class="navbar" width="100%"></th>
    449   </tr>
    450 </table>
    451 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
    452   <tr>
    453     <td align="left" class="footer">
    454     Generated by Epydoc 3.0.1 on Mon Jun  5 13:38:39 2017
    455     </td>
    456     <td align="right" class="footer">
    457       <a target="mainFrame" href="http://epydoc.sourceforge.net"
    458         >http://epydoc.sourceforge.net</a>
    459     </td>
    460   </tr>
    461 </table>
    462 
    463 <script type="text/javascript">
    464   <!--
    465   // Private objects are initially displayed (because if
    466   // javascript is turned off then we want them to be
    467   // visible); but by default, we want to hide them.  So hide
    468   // them unless we have a cookie that says to show them.
    469   checkCookie();
    470   // -->
    471 </script>
    472 </body>
    473 </html>
    474