blob: 95f9f2120c8017ea44a2120a3e799c790a2e1931 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<?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>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070060<pre class="base-tree">
61object --+
62 |
63 <strong class="uidshort">Resource</strong>
John Asmuth614db982014-04-24 15:46:26 -040064</pre>
65
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070066<hr />
67<p>A class for interacting with a resource.</p>
68
John Asmuth614db982014-04-24 15:46:26 -040069<!-- ==================== 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>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700165<tr>
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="__enter__"></a><span class="summary-sig-name">__enter__</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.__enter__">source&nbsp;code</a></span>
174
175 </td>
176 </tr>
177 </table>
178
179 </td>
180 </tr>
181<tr>
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="__exit__"></a><span class="summary-sig-name">__exit__</span>(<span class="summary-sig-arg">self</span>,
188 <span class="summary-sig-arg">exc_type</span>,
189 <span class="summary-sig-arg">exc</span>,
190 <span class="summary-sig-arg">exc_tb</span>)</span></td>
191 <td align="right" valign="top">
192 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__exit__">source&nbsp;code</a></span>
193
194 </td>
195 </tr>
196 </table>
197
198 </td>
199 </tr>
200<tr>
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="close"></a><span class="summary-sig-name">close</span>(<span class="summary-sig-arg">self</span>)</span><br />
207 Close httplib2 connections.</td>
208 <td align="right" valign="top">
209 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.close">source&nbsp;code</a></span>
210
211 </td>
212 </tr>
213 </table>
214
215 </td>
216 </tr>
John Asmuth614db982014-04-24 15:46:26 -0400217<tr class="private">
218 <td width="15%" align="right" valign="top" class="summary">
219 <span class="summary-type">&nbsp;</span>
220 </td><td class="summary">
221 <table width="100%" cellpadding="0" cellspacing="0" border="0">
222 <tr>
223 <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>
224 <td align="right" valign="top">
225 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._set_service_methods">source&nbsp;code</a></span>
226
227 </td>
228 </tr>
229 </table>
230
231 </td>
232 </tr>
233<tr class="private">
234 <td width="15%" align="right" valign="top" class="summary">
235 <span class="summary-type">&nbsp;</span>
236 </td><td class="summary">
237 <table width="100%" cellpadding="0" cellspacing="0" border="0">
238 <tr>
239 <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>,
240 <span class="summary-sig-arg">resourceDesc</span>,
241 <span class="summary-sig-arg">rootDesc</span>,
242 <span class="summary-sig-arg">schema</span>)</span></td>
243 <td align="right" valign="top">
244 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_basic_methods">source&nbsp;code</a></span>
245
246 </td>
247 </tr>
248 </table>
249
250 </td>
251 </tr>
252<tr class="private">
253 <td width="15%" align="right" valign="top" class="summary">
254 <span class="summary-type">&nbsp;</span>
255 </td><td class="summary">
256 <table width="100%" cellpadding="0" cellspacing="0" border="0">
257 <tr>
258 <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>,
259 <span class="summary-sig-arg">resourceDesc</span>,
260 <span class="summary-sig-arg">rootDesc</span>,
261 <span class="summary-sig-arg">schema</span>)</span></td>
262 <td align="right" valign="top">
263 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_nested_resources">source&nbsp;code</a></span>
264
265 </td>
266 </tr>
267 </table>
268
269 </td>
270 </tr>
271<tr class="private">
272 <td width="15%" align="right" valign="top" class="summary">
273 <span class="summary-type">&nbsp;</span>
274 </td><td class="summary">
275 <table width="100%" cellpadding="0" cellspacing="0" border="0">
276 <tr>
277 <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>,
278 <span class="summary-sig-arg">resourceDesc</span>,
279 <span class="summary-sig-arg">schema</span>)</span></td>
280 <td align="right" valign="top">
281 <span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._add_next_methods">source&nbsp;code</a></span>
282
283 </td>
284 </tr>
285 </table>
286
287 </td>
288 </tr>
289 <tr>
290 <td colspan="2" class="summary">
291 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
292 <code>__delattr__</code>,
293 <code>__format__</code>,
294 <code>__getattribute__</code>,
295 <code>__hash__</code>,
296 <code>__new__</code>,
297 <code>__reduce__</code>,
298 <code>__reduce_ex__</code>,
299 <code>__repr__</code>,
300 <code>__setattr__</code>,
301 <code>__sizeof__</code>,
302 <code>__str__</code>,
303 <code>__subclasshook__</code>
304 </p>
305 </td>
306 </tr>
307</table>
308<!-- ==================== PROPERTIES ==================== -->
309<a name="section-Properties"></a>
310<table class="summary" border="1" cellpadding="3"
311 cellspacing="0" width="100%" bgcolor="white">
312<tr bgcolor="#70b0f0" class="table-header">
313 <td colspan="2" class="table-header">
314 <table border="0" cellpadding="0" cellspacing="0" width="100%">
315 <tr valign="top">
316 <td align="left"><span class="table-header">Properties</span></td>
317 <td align="right" valign="top"
318 ><span class="options">[<a href="#section-Properties"
319 class="privatelink" onclick="toggle_private();"
320 >hide private</a>]</span></td>
321 </tr>
322 </table>
323 </td>
324</tr>
325 <tr>
326 <td colspan="2" class="summary">
327 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
328 <code>__class__</code>
329 </p>
330 </td>
331 </tr>
332</table>
333<!-- ==================== METHOD DETAILS ==================== -->
334<a name="section-MethodDetails"></a>
335<table class="details" border="1" cellpadding="3"
336 cellspacing="0" width="100%" bgcolor="white">
337<tr bgcolor="#70b0f0" class="table-header">
338 <td colspan="2" class="table-header">
339 <table border="0" cellpadding="0" cellspacing="0" width="100%">
340 <tr valign="top">
341 <td align="left"><span class="table-header">Method Details</span></td>
342 <td align="right" valign="top"
343 ><span class="options">[<a href="#section-MethodDetails"
344 class="privatelink" onclick="toggle_private();"
345 >hide private</a>]</span></td>
346 </tr>
347 </table>
348 </td>
349</tr>
350</table>
351<a name="__init__"></a>
352<div>
353<table class="details" border="1" cellpadding="3"
354 cellspacing="0" width="100%" bgcolor="white">
355<tr><td>
356 <table width="100%" cellpadding="0" cellspacing="0" border="0">
357 <tr valign="top"><td>
358 <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
359 <span class="sig-arg">http</span>,
360 <span class="sig-arg">baseUrl</span>,
361 <span class="sig-arg">model</span>,
362 <span class="sig-arg">requestBuilder</span>,
363 <span class="sig-arg">developerKey</span>,
364 <span class="sig-arg">resourceDesc</span>,
365 <span class="sig-arg">rootDesc</span>,
366 <span class="sig-arg">schema</span>)</span>
367 <br /><em class="fname">(Constructor)</em>
368 </h3>
369 </td><td align="right" valign="top"
370 ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__init__">source&nbsp;code</a></span>&nbsp;
371 </td>
372 </tr></table>
373
374 <pre class="literalblock">
375Build a Resource from the API description.
376
377Args:
378 http: httplib2.Http, Object to make http requests with.
379 baseUrl: string, base URL for the API. All requests are relative to this
380 URI.
381 model: googleapiclient.Model, converts to and from the wire format.
382 requestBuilder: class or callable that instantiates an
383 googleapiclient.HttpRequest object.
384 developerKey: string, key obtained from
385 https://code.google.com/apis/console
386 resourceDesc: object, section of deserialized discovery document that
387 describes a resource. Note that the top level discovery document
388 is considered a resource.
389 rootDesc: object, the entire deserialized discovery document.
390 schema: object, mapping of schema names to schema descriptions.
391
392</pre>
393 <dl class="fields">
394 <dt>Overrides:
395 object.__init__
396 </dt>
397 </dl>
398</td></tr></table>
399</div>
400<a name="_set_dynamic_attr"></a>
401<div class="private">
402<table class="details" border="1" cellpadding="3"
403 cellspacing="0" width="100%" bgcolor="white">
404<tr><td>
405 <table width="100%" cellpadding="0" cellspacing="0" border="0">
406 <tr valign="top"><td>
407 <h3 class="epydoc"><span class="sig"><span class="sig-name">_set_dynamic_attr</span>(<span class="sig-arg">self</span>,
408 <span class="sig-arg">attr_name</span>,
409 <span class="sig-arg">value</span>)</span>
410 </h3>
411 </td><td align="right" valign="top"
412 ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource._set_dynamic_attr">source&nbsp;code</a></span>&nbsp;
413 </td>
414 </tr></table>
415
416 <pre class="literalblock">
417Sets an instance attribute and tracks it in a list of dynamic attributes.
418
419Args:
420 attr_name: string; The name of the attribute to be set
421 value: The value being set on the object and tracked in the dynamic cache.
422
423</pre>
424 <dl class="fields">
425 </dl>
426</td></tr></table>
427</div>
428<a name="__getstate__"></a>
429<div>
430<table class="details" border="1" cellpadding="3"
431 cellspacing="0" width="100%" bgcolor="white">
432<tr><td>
433 <table width="100%" cellpadding="0" cellspacing="0" border="0">
434 <tr valign="top"><td>
435 <h3 class="epydoc"><span class="sig"><span class="sig-name">__getstate__</span>(<span class="sig-arg">self</span>)</span>
436 </h3>
437 </td><td align="right" valign="top"
438 ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__getstate__">source&nbsp;code</a></span>&nbsp;
439 </td>
440 </tr></table>
441
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700442 <p>Trim the state down to something that can be pickled.</p>
443 <p>Uses the fact that the instance variable _dynamic_attrs holds attrs
444 that will be wiped and restored on pickle serialization.</p>
John Asmuth614db982014-04-24 15:46:26 -0400445 <dl class="fields">
446 </dl>
447</td></tr></table>
448</div>
449<a name="__setstate__"></a>
450<div>
451<table class="details" border="1" cellpadding="3"
452 cellspacing="0" width="100%" bgcolor="white">
453<tr><td>
454 <table width="100%" cellpadding="0" cellspacing="0" border="0">
455 <tr valign="top"><td>
456 <h3 class="epydoc"><span class="sig"><span class="sig-name">__setstate__</span>(<span class="sig-arg">self</span>,
457 <span class="sig-arg">state</span>)</span>
458 </h3>
459 </td><td align="right" valign="top"
460 ><span class="codelink"><a href="googleapiclient.discovery-pysrc.html#Resource.__setstate__">source&nbsp;code</a></span>&nbsp;
461 </td>
462 </tr></table>
463
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700464 <p>Reconstitute the state of the object from being pickled.</p>
465 <p>Uses the fact that the instance variable _dynamic_attrs holds attrs
466 that will be wiped and restored on pickle serialization.</p>
John Asmuth614db982014-04-24 15:46:26 -0400467 <dl class="fields">
468 </dl>
469</td></tr></table>
470</div>
471<br />
472<!-- ==================== NAVIGATION BAR ==================== -->
473<table class="navbar" border="0" width="100%" cellpadding="0"
474 bgcolor="#a0c0ff" cellspacing="0">
475 <tr valign="middle">
476 <!-- Home link -->
477 <th>&nbsp;&nbsp;&nbsp;<a
478 href="googleapiclient-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
479
480 <!-- Tree link -->
481 <th>&nbsp;&nbsp;&nbsp;<a
482 href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
483
484 <!-- Index link -->
485 <th>&nbsp;&nbsp;&nbsp;<a
486 href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
487
488 <!-- Help link -->
489 <th>&nbsp;&nbsp;&nbsp;<a
490 href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
491
492 <th class="navbar" width="100%"></th>
493 </tr>
494</table>
495<table border="0" cellpadding="0" cellspacing="0" width="100%%">
496 <tr>
497 <td align="left" class="footer">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700498 Generated by Epydoc 3.0.1 on Fri Oct 2 20:46:22 2020
John Asmuth614db982014-04-24 15:46:26 -0400499 </td>
500 <td align="right" class="footer">
501 <a target="mainFrame" href="http://epydoc.sourceforge.net"
502 >http://epydoc.sourceforge.net</a>
503 </td>
504 </tr>
505</table>
506
507<script type="text/javascript">
508 <!--
509 // Private objects are initially displayed (because if
510 // javascript is turned off then we want them to be
511 // visible); but by default, we want to hide them. So hide
512 // them unless we have a cookie that says to show them.
513 checkCookie();
514 // -->
515</script>
516</body>
517</html>