Blame - docs/apiclient.model.html - platform/external/python/google-api-python-client

><a href=".">index</a> <a href="file:/usr/local/google/home/jcgregorio/projects/apiclient/apiclient/model.py">/usr/local/google/home/jcgregorio/projects/apiclient/apiclient/model.py</a></td></tr></table>

12

<tt><a href="#Model">Model</a> objects for requests and responses.

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

13

14

Each API may support one or more serializations, such

15

as JSON, Atom, etc. The model classes are responsible

16

for converting between the wire format and the Python

17

<a href="__builtin__.html#object">object</a> representation.</tt>

<big>Modules</big></td></tr>

23

24

25

<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="logging.html">logging</a>

26

</td><td width="25%" valign=top><a href="simplejson.html">simplejson</a>

27

</td><td width="25%" valign=top><a href="urllib.html">urllib</a>

28

</td><td width="25%" valign=top></td></tr></table></td></tr></table>

<big>Classes</big></td></tr>

<dt><a href="__builtin__.html#object">__builtin__.object</a>

37

</dt><dd>

38

<dl>

Joe Gregorio

abda96f

2011-02-11 20:19:33 -0500

[diff] [blame]

39

<dt><a href="apiclient.model.html#Model">Model</a>

40

</dt><dd>

41

<dl>

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

42

<dt><a href="apiclient.model.html#JsonModel">JsonModel</a>

43

</dt></dl>

44

</dd>

45

</dl>

Joe Gregorio

abda96f

2011-02-11 20:19:33 -0500

[diff] [blame]

46

</dd>

47

</dl>

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

Joe Gregorio

2011-02-11 20:19:33 -0500

[diff] [blame]

52

<a name="JsonModel">class JsonModel</a>(<a href="apiclient.model.html#Model">Model</a>)</td></tr>

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

53

54

Joe Gregorio

abda96f

2011-02-11 20:19:33 -0500

[diff] [blame]

55

<td colspan=2><tt><a href="#Model">Model</a> class for JSON.

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

56

57

Serializes and de-serializes between JSON and the Python

58

<a href="__builtin__.html#object">object</a> representation of HTTP request and response bodies.  </tt></td></tr>

59

Joe Gregorio

abda96f

2011-02-11 20:19:33 -0500

[diff] [blame]

60

<td width="100%"><dl><dt>Method resolution order:</dt>

61

<dd><a href="apiclient.model.html#JsonModel">JsonModel</a></dd>

62

<dd><a href="apiclient.model.html#Model">Model</a></dd>

63

<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>

64

</dl>

65

<hr>

66

Methods defined here:

Joe Gregorio

30dfdc3

2010-12-09 16:34:22 -0500

[diff] [blame]

67

<dl><dt><a name="JsonModel-request">request</a>(self, headers, path_params, query_params, body_value)</dt><dd><tt>Updates outgoing requests with JSON bodies.

68

69

Args:

70

headers: dict, request headers

71

path_params: dict, parameters that appear in the request path

72

query_params: dict, parameters that appear in the query

73

body_value: <a href="__builtin__.html#object">object</a>, the request body as a Python <a href="__builtin__.html#object">object</a>, which must be

74

serializable by simplejson.

75

Returns:

76

A tuple of (headers, path_params, query, body)

77

78

headers: dict, request headers

79

path_params: dict, parameters that appear in the request path

80

query: string, query part of the request URI

81

body: string, the body serialized as JSON</tt></dd></dl>

82

83

<dl><dt><a name="JsonModel-response">response</a>(self, resp, content)</dt><dd><tt>Convert the response wire format into a Python <a href="__builtin__.html#object">object</a>.

84

85

Args:

86

resp: httplib2.Response, the HTTP response headers and status

87

content: string, the body of the HTTP response

88

89

Returns:

90

The body de-serialized as a Python <a href="__builtin__.html#object">object</a>.

91

92

Raises:

93

apiclient.errors.HttpError if a non 2xx response is received.</tt></dd></dl>

94

95

<hr>

Joe Gregorio

abda96f

2011-02-11 20:19:33 -0500

[diff] [blame]

96

Data descriptors inherited from <a href="apiclient.model.html#Model">Model</a>:

97

98

<dd><tt>dictionary for instance variables (if defined)</tt></dd>

99

</dl>

100

<dl><dt>__weakref__</dt>

101

<dd><tt>list of weak references to the object (if defined)</tt></dd>

</dl>

</td></tr></table>

<a name="Model">class Model</a>(<a href="__builtin__.html#object">__builtin__.object</a>)</td></tr>

108

109

110

<td colspan=2><tt><a href="#Model">Model</a> base class.

111

112

All <a href="#Model">Model</a> classes should implement this interface.

113

The <a href="#Model">Model</a> serializes and de-serializes between a wire

114

format such as JSON and a Python <a href="__builtin__.html#object">object</a> representation.  </tt></td></tr>

115

116

<td width="100%">Methods defined here:

117

<dl><dt><a name="Model-request">request</a>(self, headers, path_params, query_params, body_value)</dt><dd><tt>Updates outgoing requests with a deserialized body.

118

119

Args:

120

headers: dict, request headers

121

path_params: dict, parameters that appear in the request path

122

query_params: dict, parameters that appear in the query

123

body_value: <a href="__builtin__.html#object">object</a>, the request body as a Python <a href="__builtin__.html#object">object</a>, which must be

124

serializable.

125

Returns:

126

A tuple of (headers, path_params, query, body)

127

128

headers: dict, request headers

129

path_params: dict, parameters that appear in the request path

130

query: string, query part of the request URI

131

body: string, the body serialized in the desired wire format.</tt></dd></dl>

132

133

<dl><dt><a name="Model-response">response</a>(self, resp, content)</dt><dd><tt>Convert the response wire format into a Python <a href="__builtin__.html#object">object</a>.

134

135

Args:

136

resp: httplib2.Response, the HTTP response headers and status

137

content: string, the body of the HTTP response

138

139

Returns:

140

The body de-serialized as a Python <a href="__builtin__.html#object">object</a>.