Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / abda96fe2c63e68b5073f8c307b129090f0e2044 / . / docs / apiclient.discovery.html
blob: dd83c1b3f6982733be90e38a033b12491c2ca05f [file] [log] [blame]
Joe Gregorio30dfdc32010-12-09 16:34:22 -0500[diff] [blame]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: module apiclient.discovery</title>
4</head><body bgcolor="#f0f0f8">
5
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
7<tr bgcolor="#7799ee">
8<td valign=bottom>&nbsp;<br>
9<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong><a href="apiclient.html"><font color="#ffffff">apiclient</font></a>.discovery</strong></big></big></font></td
10><td align=right valign=bottom
Joe Gregorio6e537032011-02-09 23:04:26 -0500[diff] [blame]11><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/jcgregorio/projects/apiary/apiclient/discovery.py">/home/jcgregorio/projects/apiary/apiclient/discovery.py</a></font></td></tr></table>
Joe Gregorio30dfdc32010-12-09 16:34:22 -0500[diff] [blame]12 <p><tt>Client&nbsp;for&nbsp;discovery&nbsp;based&nbsp;APIs<br>
13&nbsp;<br>
14A&nbsp;client&nbsp;library&nbsp;for&nbsp;Google's&nbsp;discovery<br>
15based&nbsp;APIs.</tt></p>
16<p>
17<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
18<tr bgcolor="#aa55cc">
19<td colspan=3 valign=bottom>&nbsp;<br>
20<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
21
22<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
23<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="httplib2.html">httplib2</a><br>
24<a href="logging.html">logging</a><br>
25</td><td width="25%" valign=top><a href="os.html">os</a><br>
26<a href="re.html">re</a><br>
27</td><td width="25%" valign=top><a href="simplejson.html">simplejson</a><br>
28<a href="uritemplate.html">uritemplate</a><br>
29</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
30<a href="urlparse.html">urlparse</a><br>
31</td></tr></table></td></tr></table><p>
32<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
33<tr bgcolor="#eeaa77">
34<td colspan=3 valign=bottom>&nbsp;<br>
35<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
36
37<tr><td bgcolor="#eeaa77"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
Joe Gregorioabda96f2011-02-11 20:19:33 -0500[diff] [blame^]38<td width="100%"><dl><dt><a name="-build"><strong>build</strong></a>(serviceName, version, http<font color="#909090">=None</font>, discoveryServiceUrl<font color="#909090">='https://www.googleapis.com/discovery/v0.2beta1/describe/{api}/{apiVersion}'</font>, developerKey<font color="#909090">=None</font>, model<font color="#909090">=&lt;apiclient.model.JsonModel object&gt;</font>, requestBuilder<font color="#909090">=&lt;class 'apiclient.http.HttpRequest'&gt;</font>)</dt><dd><tt>Construct&nbsp;a&nbsp;Resource&nbsp;for&nbsp;interacting&nbsp;with&nbsp;an&nbsp;API.<br>
39&nbsp;<br>
40Construct&nbsp;a&nbsp;Resource&nbsp;object&nbsp;for&nbsp;interacting&nbsp;with<br>
41an&nbsp;API.&nbsp;The&nbsp;serviceName&nbsp;and&nbsp;version&nbsp;are&nbsp;the<br>
42names&nbsp;from&nbsp;the&nbsp;Discovery&nbsp;service.<br>
43&nbsp;<br>
44Args:<br>
45&nbsp;&nbsp;serviceName:&nbsp;string,&nbsp;name&nbsp;of&nbsp;the&nbsp;service<br>
46&nbsp;&nbsp;version:&nbsp;string,&nbsp;the&nbsp;version&nbsp;of&nbsp;the&nbsp;service<br>
47&nbsp;&nbsp;discoveryServiceUrl:&nbsp;string,&nbsp;a&nbsp;URI&nbsp;Template&nbsp;that&nbsp;points&nbsp;to<br>
48&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;location&nbsp;of&nbsp;the&nbsp;discovery&nbsp;service.&nbsp;It&nbsp;should&nbsp;have&nbsp;two<br>
49&nbsp;&nbsp;&nbsp;&nbsp;parameters&nbsp;{api}&nbsp;and&nbsp;{apiVersion}&nbsp;that&nbsp;when&nbsp;filled&nbsp;in<br>
50&nbsp;&nbsp;&nbsp;&nbsp;produce&nbsp;an&nbsp;absolute&nbsp;URI&nbsp;to&nbsp;the&nbsp;discovery&nbsp;document&nbsp;for<br>
51&nbsp;&nbsp;&nbsp;&nbsp;that&nbsp;service.<br>
52&nbsp;&nbsp;developerKey:&nbsp;string,&nbsp;key&nbsp;obtained&nbsp;from&nbsp;https://code.google.com/apis/console<br>
53&nbsp;&nbsp;model:&nbsp;apiclient.Model,&nbsp;converts&nbsp;to&nbsp;and&nbsp;from&nbsp;the&nbsp;wire&nbsp;format<br>
54&nbsp;&nbsp;requestBuilder:&nbsp;apiclient.http.HttpRequest,&nbsp;encapsulator&nbsp;for&nbsp;an&nbsp;HTTP&nbsp;request<br>
55&nbsp;<br>
56Returns:<br>
57&nbsp;&nbsp;A&nbsp;Resource&nbsp;object&nbsp;with&nbsp;methods&nbsp;for&nbsp;interacting&nbsp;with<br>
58&nbsp;&nbsp;the&nbsp;service.</tt></dd></dl>
59 <dl><dt><a name="-build_from_document"><strong>build_from_document</strong></a>(service, base, future<font color="#909090">=None</font>, http<font color="#909090">=None</font>, developerKey<font color="#909090">=None</font>, model<font color="#909090">=&lt;apiclient.model.JsonModel object&gt;</font>, requestBuilder<font color="#909090">=&lt;class 'apiclient.http.HttpRequest'&gt;</font>)</dt><dd><tt>Create&nbsp;a&nbsp;Resource&nbsp;for&nbsp;interacting&nbsp;with&nbsp;an&nbsp;API.<br>
60&nbsp;<br>
61Same&nbsp;as&nbsp;`<a href="#-build">build</a>()`,&nbsp;but&nbsp;constructs&nbsp;the&nbsp;Resource&nbsp;object<br>
62from&nbsp;a&nbsp;discovery&nbsp;document&nbsp;that&nbsp;is&nbsp;it&nbsp;given,&nbsp;as&nbsp;opposed&nbsp;to<br>
63retrieving&nbsp;one&nbsp;over&nbsp;HTTP.<br>
64&nbsp;<br>
65Args:<br>
Joe Gregorio6e537032011-02-09 23:04:26 -0500[diff] [blame]66&nbsp;&nbsp;service:&nbsp;string,&nbsp;discovery&nbsp;document<br>
67&nbsp;&nbsp;base:&nbsp;string,&nbsp;base&nbsp;URI&nbsp;for&nbsp;all&nbsp;HTTP&nbsp;requests,&nbsp;usually&nbsp;the&nbsp;discovery&nbsp;URI<br>
68&nbsp;&nbsp;future:&nbsp;string,&nbsp;discovery&nbsp;document&nbsp;with&nbsp;future&nbsp;capabilities<br>
69&nbsp;&nbsp;auth_discovery:&nbsp;dict,&nbsp;information&nbsp;about&nbsp;the&nbsp;authentication&nbsp;the&nbsp;API&nbsp;supports<br>
70&nbsp;&nbsp;http:&nbsp;httplib2.Http,&nbsp;An&nbsp;instance&nbsp;of&nbsp;httplib2.Http&nbsp;or&nbsp;something&nbsp;that&nbsp;acts<br>
71&nbsp;&nbsp;&nbsp;&nbsp;like&nbsp;it&nbsp;that&nbsp;HTTP&nbsp;requests&nbsp;will&nbsp;be&nbsp;made&nbsp;through.<br>
72&nbsp;&nbsp;developerKey:&nbsp;string,&nbsp;Key&nbsp;for&nbsp;controlling&nbsp;API&nbsp;usage,&nbsp;generated<br>
73&nbsp;&nbsp;&nbsp;&nbsp;from&nbsp;the&nbsp;API&nbsp;Console.<br>
74&nbsp;&nbsp;model:&nbsp;Model&nbsp;class&nbsp;instance&nbsp;that&nbsp;serializes&nbsp;and<br>
75&nbsp;&nbsp;&nbsp;&nbsp;de-serializes&nbsp;requests&nbsp;and&nbsp;responses.<br>
Joe Gregorioabda96f2011-02-11 20:19:33 -0500[diff] [blame^]76&nbsp;&nbsp;requestBuilder:&nbsp;Takes&nbsp;an&nbsp;http&nbsp;request&nbsp;and&nbsp;packages&nbsp;it&nbsp;up&nbsp;to&nbsp;be&nbsp;executed.<br>
77&nbsp;<br>
78Returns:<br>
79&nbsp;&nbsp;A&nbsp;Resource&nbsp;object&nbsp;with&nbsp;methods&nbsp;for&nbsp;interacting&nbsp;with<br>
80&nbsp;&nbsp;the&nbsp;service.</tt></dd></dl>
Joe Gregorio30dfdc32010-12-09 16:34:22 -0500[diff] [blame]81</td></tr></table><p>
82<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
83<tr bgcolor="#55aa55">
84<td colspan=3 valign=bottom>&nbsp;<br>
85<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
86
87<tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
Joe Gregorioabda96f2011-02-11 20:19:33 -0500[diff] [blame^]88<td width="100%"><strong>__all__</strong> = ['build', 'build_from_document']<br>
Joe Gregorio30dfdc32010-12-09 16:34:22 -0500[diff] [blame]89<strong>__author__</strong> = 'jcgregorio@google.com (Joe Gregorio)'</td></tr></table><p>
90<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
91<tr bgcolor="#7799ee">
92<td colspan=3 valign=bottom>&nbsp;<br>
93<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
94
95<tr><td bgcolor="#7799ee"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
96<td width="100%">jcgregorio@google.com&nbsp;(Joe&nbsp;Gregorio)</td></tr></table>
97</body></html>