Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 66212035140c8f3abfb6ed14a40db27dbef4d220 / . / docs / dyn / blogger.v2.posts.html
blob: a750205c3cf51e705e8ab449efcab3182317c70c [file] [log] [blame]
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: class Resource</title>
4</head><body bgcolor="#f0f0f8">
5<p>
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
7<tr bgcolor="#ffc8d8">
8<td colspan=3 valign=bottom>&nbsp;<br>
9<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
10
11<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
12<td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
13<tr><td>&nbsp;</td>
14<td width="100%">Methods defined here:<br>
15<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>
16
17<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Get&nbsp;a&nbsp;post&nbsp;by&nbsp;id.<br>
18&nbsp;<br>
19Args:<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame^]20&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
21&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
22&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
23&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]24&nbsp;&nbsp;postId:&nbsp;string,&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;post&nbsp;(required)<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -0500[diff] [blame]25&nbsp;&nbsp;blogId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;blog&nbsp;to&nbsp;fetch&nbsp;the&nbsp;post&nbsp;from.&nbsp;(required)<br>
26&nbsp;<br>
27Returns:<br>
28&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
29&nbsp;<br>
30&nbsp;&nbsp;&nbsp;&nbsp;{<br>
31&nbsp;&nbsp;&nbsp;&nbsp;"content":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;content&nbsp;of&nbsp;the&nbsp;Post.&nbsp;May&nbsp;contain&nbsp;HTML&nbsp;markup.<br>
32&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"blogger#post",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;entity.&nbsp;Always&nbsp;blogger#post<br>
33&nbsp;&nbsp;&nbsp;&nbsp;"author":&nbsp;{&nbsp;#&nbsp;The&nbsp;author&nbsp;of&nbsp;this&nbsp;Post.<br>
34&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;of&nbsp;the&nbsp;Post&nbsp;creator's&nbsp;Profile&nbsp;page.<br>
35&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"image":&nbsp;{&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar.<br>
36&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar&nbsp;URL.<br>
37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
38&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;display&nbsp;name.<br>
39&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;the&nbsp;Post&nbsp;creator.<br>
40&nbsp;&nbsp;&nbsp;&nbsp;},<br>
41&nbsp;&nbsp;&nbsp;&nbsp;"replies":&nbsp;{&nbsp;#&nbsp;The&nbsp;container&nbsp;of&nbsp;comments&nbsp;on&nbsp;this&nbsp;Post.<br>
42&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"totalItems":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;count&nbsp;of&nbsp;comments&nbsp;on&nbsp;this&nbsp;post.<br>
43&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;of&nbsp;the&nbsp;comments&nbsp;on&nbsp;this&nbsp;post.<br>
44&nbsp;&nbsp;&nbsp;&nbsp;},<br>
45&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;[&nbsp;#&nbsp;The&nbsp;list&nbsp;of&nbsp;labels&nbsp;this&nbsp;Post&nbsp;was&nbsp;tagged&nbsp;with.<br>
46&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
47&nbsp;&nbsp;&nbsp;&nbsp;],<br>
48&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;date-time&nbsp;when&nbsp;this&nbsp;Post&nbsp;was&nbsp;last&nbsp;updated.<br>
49&nbsp;&nbsp;&nbsp;&nbsp;"blog":&nbsp;{&nbsp;#&nbsp;Data&nbsp;about&nbsp;the&nbsp;blog&nbsp;containing&nbsp;this&nbsp;Post.<br>
50&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;the&nbsp;Blog&nbsp;that&nbsp;contains&nbsp;this&nbsp;Post.<br>
51&nbsp;&nbsp;&nbsp;&nbsp;},<br>
52&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;where&nbsp;this&nbsp;Post&nbsp;is&nbsp;displayed.<br>
53&nbsp;&nbsp;&nbsp;&nbsp;"published":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;date-time&nbsp;when&nbsp;this&nbsp;Post&nbsp;was&nbsp;published.<br>
54&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;the&nbsp;Post.<br>
55&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;this&nbsp;Post.<br>
56&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;API&nbsp;REST&nbsp;URL&nbsp;to&nbsp;fetch&nbsp;this&nbsp;resource&nbsp;from.<br>
57&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]58
59<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves&nbsp;a&nbsp;list&nbsp;of&nbsp;posts,&nbsp;possibly&nbsp;filtered.<br>
60&nbsp;<br>
61Args:<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame^]62&nbsp;&nbsp;startDate:&nbsp;string,&nbsp;Earliest&nbsp;post&nbsp;date&nbsp;to&nbsp;fetch,&nbsp;a&nbsp;date-time&nbsp;with&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;formatting.<br>
63&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
64&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]65&nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;Continuation&nbsp;token&nbsp;if&nbsp;the&nbsp;request&nbsp;is&nbsp;paged.<br>
66&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;posts&nbsp;to&nbsp;fetch.<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame^]67&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
68&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]69&nbsp;&nbsp;fetchBodies:&nbsp;boolean,&nbsp;Whether&nbsp;the&nbsp;body&nbsp;content&nbsp;of&nbsp;posts&nbsp;is&nbsp;included.<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -0500[diff] [blame]70&nbsp;&nbsp;blogId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;blog&nbsp;to&nbsp;fetch&nbsp;posts&nbsp;from.&nbsp;(required)<br>
71&nbsp;<br>
72Returns:<br>
73&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
74&nbsp;<br>
75&nbsp;&nbsp;&nbsp;&nbsp;{<br>
76&nbsp;&nbsp;&nbsp;&nbsp;"nextPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Pagination&nbsp;token&nbsp;to&nbsp;fetch&nbsp;the&nbsp;next&nbsp;page,&nbsp;if&nbsp;one&nbsp;exists.<br>
77&nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;The&nbsp;list&nbsp;of&nbsp;Posts&nbsp;for&nbsp;this&nbsp;Blog.<br>
78&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
79&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"content":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;content&nbsp;of&nbsp;the&nbsp;Post.&nbsp;May&nbsp;contain&nbsp;HTML&nbsp;markup.<br>
80&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"blogger#post",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;entity.&nbsp;Always&nbsp;blogger#post<br>
81&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"author":&nbsp;{&nbsp;#&nbsp;The&nbsp;author&nbsp;of&nbsp;this&nbsp;Post.<br>
82&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;of&nbsp;the&nbsp;Post&nbsp;creator's&nbsp;Profile&nbsp;page.<br>
83&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"image":&nbsp;{&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar.<br>
84&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar&nbsp;URL.<br>
85&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
86&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;display&nbsp;name.<br>
87&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;the&nbsp;Post&nbsp;creator.<br>
88&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
89&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"replies":&nbsp;{&nbsp;#&nbsp;The&nbsp;container&nbsp;of&nbsp;comments&nbsp;on&nbsp;this&nbsp;Post.<br>
90&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"totalItems":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;count&nbsp;of&nbsp;comments&nbsp;on&nbsp;this&nbsp;post.<br>
91&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;of&nbsp;the&nbsp;comments&nbsp;on&nbsp;this&nbsp;post.<br>
92&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
93&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;[&nbsp;#&nbsp;The&nbsp;list&nbsp;of&nbsp;labels&nbsp;this&nbsp;Post&nbsp;was&nbsp;tagged&nbsp;with.<br>
94&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
95&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
96&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"updated":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;date-time&nbsp;when&nbsp;this&nbsp;Post&nbsp;was&nbsp;last&nbsp;updated.<br>
97&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"blog":&nbsp;{&nbsp;#&nbsp;Data&nbsp;about&nbsp;the&nbsp;blog&nbsp;containing&nbsp;this&nbsp;Post.<br>
98&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;the&nbsp;Blog&nbsp;that&nbsp;contains&nbsp;this&nbsp;Post.<br>
99&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
100&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"url":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;URL&nbsp;where&nbsp;this&nbsp;Post&nbsp;is&nbsp;displayed.<br>
101&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"published":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;date-time&nbsp;when&nbsp;this&nbsp;Post&nbsp;was&nbsp;published.<br>
102&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;the&nbsp;Post.<br>
103&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;this&nbsp;Post.<br>
104&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;API&nbsp;REST&nbsp;URL&nbsp;to&nbsp;fetch&nbsp;this&nbsp;resource&nbsp;from.<br>
105&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
106&nbsp;&nbsp;&nbsp;&nbsp;],<br>
107&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"blogger#postList",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;entity.&nbsp;Always&nbsp;blogger#postList<br>
108&nbsp;&nbsp;&nbsp;&nbsp;"prevPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Pagination&nbsp;token&nbsp;to&nbsp;fetch&nbsp;the&nbsp;previous&nbsp;page,&nbsp;if&nbsp;one&nbsp;exists.<br>
109&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]110
111<dl><dt><a name="Resource-list_next"><strong>list_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.<br>
112&nbsp;<br>
113Args:<br>
114&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
115&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
116&nbsp;<br>
117Returns:<br>
118&nbsp;&nbsp;A&nbsp;request&nbsp;object&nbsp;that&nbsp;you&nbsp;can&nbsp;call&nbsp;'execute()'&nbsp;on&nbsp;to&nbsp;request&nbsp;the&nbsp;next<br>
119&nbsp;&nbsp;page.&nbsp;Returns&nbsp;None&nbsp;if&nbsp;there&nbsp;are&nbsp;no&nbsp;more&nbsp;items&nbsp;in&nbsp;the&nbsp;collection.</tt></dd></dl>
120
121<hr>
122Data descriptors defined here:<br>
123<dl><dt><strong>__dict__</strong></dt>
124<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
125</dl>
126<dl><dt><strong>__weakref__</strong></dt>
127<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
128</dl>
129</td></tr></table>
130</body></html>