Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / d02bf5ee3860a50d36f960cd2c90ab6d1ecec7cd / . / docs / dyn / blogger.v2.posts.html
blob: 7d05ffe0fd31477d6b41e38b135921f3a6853b85 [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>
20&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]21&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>
22&nbsp;<br>
23Returns:<br>
24&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
25&nbsp;<br>
26&nbsp;&nbsp;&nbsp;&nbsp;{<br>
27&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>
28&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>
29&nbsp;&nbsp;&nbsp;&nbsp;"author":&nbsp;{&nbsp;#&nbsp;The&nbsp;author&nbsp;of&nbsp;this&nbsp;Post.<br>
30&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>
31&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"image":&nbsp;{&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar.<br>
32&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>
33&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
34&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;display&nbsp;name.<br>
35&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>
36&nbsp;&nbsp;&nbsp;&nbsp;},<br>
37&nbsp;&nbsp;&nbsp;&nbsp;"replies":&nbsp;{&nbsp;#&nbsp;The&nbsp;container&nbsp;of&nbsp;comments&nbsp;on&nbsp;this&nbsp;Post.<br>
38&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>
39&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>
40&nbsp;&nbsp;&nbsp;&nbsp;},<br>
41&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>
42&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
43&nbsp;&nbsp;&nbsp;&nbsp;],<br>
44&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>
45&nbsp;&nbsp;&nbsp;&nbsp;"blog":&nbsp;{&nbsp;#&nbsp;Data&nbsp;about&nbsp;the&nbsp;blog&nbsp;containing&nbsp;this&nbsp;Post.<br>
46&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>
47&nbsp;&nbsp;&nbsp;&nbsp;},<br>
48&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>
49&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>
50&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;the&nbsp;Post.<br>
51&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;identifier&nbsp;of&nbsp;this&nbsp;Post.<br>
52&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>
53&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]54
55<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>
56&nbsp;<br>
57Args:<br>
58&nbsp;&nbsp;startDate:&nbsp;string,&nbsp;Earliest&nbsp;post&nbsp;date&nbsp;to&nbsp;fetch.<br>
59&nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;Continuation&nbsp;token&nbsp;if&nbsp;the&nbsp;request&nbsp;is&nbsp;paged.<br>
60&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;posts&nbsp;to&nbsp;fetch.<br>
61&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]62&nbsp;&nbsp;blogId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;blog&nbsp;to&nbsp;fetch&nbsp;posts&nbsp;from.&nbsp;(required)<br>
63&nbsp;<br>
64Returns:<br>
65&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
66&nbsp;<br>
67&nbsp;&nbsp;&nbsp;&nbsp;{<br>
68&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>
69&nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;The&nbsp;list&nbsp;of&nbsp;Posts&nbsp;for&nbsp;this&nbsp;Blog.<br>
70&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
71&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>
72&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>
73&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"author":&nbsp;{&nbsp;#&nbsp;The&nbsp;author&nbsp;of&nbsp;this&nbsp;Post.<br>
74&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>
75&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"image":&nbsp;{&nbsp;#&nbsp;The&nbsp;Post&nbsp;author's&nbsp;avatar.<br>
76&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>
77&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
78&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"displayName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;display&nbsp;name.<br>
79&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>
80&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
81&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>
82&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>
83&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>
84&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
85&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>
86&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
87&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
88&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>
89&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>
90&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>
91&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
92&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>
93&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>
94&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>
95&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>
96&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>
97&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
98&nbsp;&nbsp;&nbsp;&nbsp;],<br>
99&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>
100&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>
101&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioa8451672011-09-15 09:53:21 -0400[diff] [blame]102
103<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>
104&nbsp;<br>
105Args:<br>
106&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
107&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
108&nbsp;<br>
109Returns:<br>
110&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>
111&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>
112
113<hr>
114Data descriptors defined here:<br>
115<dl><dt><strong>__dict__</strong></dt>
116<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
117</dl>
118<dl><dt><strong>__weakref__</strong></dt>
119<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
120</dl>
121</td></tr></table>
122</body></html>