blob: 40a61e654fdfc6ba7064a524f3f4f8425b7b70ca [file] [log] [blame]
Sai Cheemalapatidf613972016-10-21 13:59:49 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Dan O'Mearadd494642020-05-01 07:42:23 -070075<h1><a href="blogger_v2.html">Blogger API v3</a> . <a href="blogger_v2.posts.html">posts</a></h1>
Sai Cheemalapatidf613972016-10-21 13:59:49 -070076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070081 <code><a href="#get">get(blogId, postId, x__xgafv=None)</a></code></p>
82<p class="firstline">Gets a post by blog id and post id</p>
Sai Cheemalapatidf613972016-10-21 13:59:49 -070083<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070084 <code><a href="#list">list(blogId, startDate=None, fetchBodies=None, pageToken=None, maxResults=None, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -070085<p class="firstline">Lists posts.</p>
Sai Cheemalapatidf613972016-10-21 13:59:49 -070086<p class="toc_element">
87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
89<h3>Method Details</h3>
90<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070091 <code class="details" id="close">close()</code>
92 <pre>Close httplib2 connections.</pre>
93</div>
94
95<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -070096 <code class="details" id="get">get(blogId, postId, x__xgafv=None)</code>
97 <pre>Gets a post by blog id and post id
Sai Cheemalapatidf613972016-10-21 13:59:49 -070098
99Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700100 blogId: string, A parameter (required)
101 postId: string, A parameter (required)
102 x__xgafv: string, V1 error format.
103 Allowed values
104 1 - v1 error format
105 2 - v2 error format
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700106
107Returns:
108 An object of the form:
109
110 {
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700111 &quot;author&quot;: { # The author of this Post.
112 &quot;displayName&quot;: &quot;A String&quot;, # The display name.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700113 &quot;url&quot;: &quot;A String&quot;, # The URL of the creator&#x27;s Profile page.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700114 &quot;id&quot;: &quot;A String&quot;, # The identifier of the creator.
115 &quot;image&quot;: { # The creator&#x27;s avatar.
116 &quot;url&quot;: &quot;A String&quot;, # The creator&#x27;s avatar URL.
117 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700118 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700119 &quot;published&quot;: &quot;A String&quot;, # RFC 3339 date-time when this Post was published.
Bu Sun Kim65020912020-05-20 12:08:20 -0700120 &quot;images&quot;: [ # Display image for the Post.
Dan O'Mearadd494642020-05-01 07:42:23 -0700121 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700122 &quot;url&quot;: &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700123 },
124 ],
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700125 &quot;updated&quot;: &quot;A String&quot;, # RFC 3339 date-time when this Post was last updated.
126 &quot;labels&quot;: [ # The list of labels this Post was tagged with.
127 &quot;A String&quot;,
128 ],
129 &quot;customMetaData&quot;: &quot;A String&quot;, # The JSON meta-data for the Post.
130 &quot;titleLink&quot;: &quot;A String&quot;, # The title link URL, similar to atom&#x27;s related link.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700131 &quot;url&quot;: &quot;A String&quot;, # The URL where this Post is displayed.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700132 &quot;blog&quot;: { # Data about the blog containing this Post.
133 &quot;id&quot;: &quot;A String&quot;, # The identifier of the Blog that contains this Post.
134 },
135 &quot;location&quot;: { # The location for geotagged posts.
136 &quot;name&quot;: &quot;A String&quot;, # Location name.
137 &quot;lng&quot;: 3.14, # Location&#x27;s longitude.
138 &quot;span&quot;: &quot;A String&quot;, # Location&#x27;s viewport span. Can be used when rendering a map preview.
139 &quot;lat&quot;: 3.14, # Location&#x27;s latitude.
140 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700141 &quot;content&quot;: &quot;A String&quot;, # The content of the Post. May contain HTML markup.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700142 &quot;selfLink&quot;: &quot;A String&quot;, # The API REST URL to fetch this resource from.
143 &quot;replies&quot;: { # The container of comments on this Post.
144 &quot;totalItems&quot;: &quot;A String&quot;, # The count of comments on this post.
145 &quot;selfLink&quot;: &quot;A String&quot;, # The URL of the comments on this post.
146 &quot;items&quot;: [ # The List of Comments for this Post.
147 {
148 &quot;author&quot;: { # The author of this Comment.
149 &quot;displayName&quot;: &quot;A String&quot;, # The display name.
150 &quot;id&quot;: &quot;A String&quot;, # The identifier of the creator.
151 &quot;url&quot;: &quot;A String&quot;, # The URL of the creator&#x27;s Profile page.
152 &quot;image&quot;: { # The creator&#x27;s avatar.
153 &quot;url&quot;: &quot;A String&quot;, # The creator&#x27;s avatar URL.
154 },
155 },
156 &quot;content&quot;: &quot;A String&quot;, # The actual content of the comment. May include HTML markup.
157 &quot;id&quot;: &quot;A String&quot;, # The identifier for this resource.
158 &quot;updated&quot;: &quot;A String&quot;, # RFC 3339 date-time when this comment was last updated.
159 &quot;published&quot;: &quot;A String&quot;, # RFC 3339 date-time when this comment was published.
160 &quot;status&quot;: &quot;A String&quot;, # The status of the comment (only populated for admin users).
161 &quot;blog&quot;: { # Data about the blog containing this comment.
162 &quot;id&quot;: &quot;A String&quot;, # The identifier of the blog containing this comment.
163 },
164 &quot;kind&quot;: &quot;A String&quot;, # The kind of this entry. Always blogger#comment.
165 &quot;inReplyTo&quot;: { # Data about the comment this is in reply to.
166 &quot;id&quot;: &quot;A String&quot;, # The identified of the parent of this comment.
167 },
168 &quot;selfLink&quot;: &quot;A String&quot;, # The API REST URL to fetch this resource from.
169 &quot;post&quot;: { # Data about the post containing this comment.
170 &quot;id&quot;: &quot;A String&quot;, # The identifier of the post containing this comment.
171 },
172 },
173 ],
174 },
175 &quot;title&quot;: &quot;A String&quot;, # The title of the Post.
176 &quot;id&quot;: &quot;A String&quot;, # The identifier of this Post.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700177 &quot;status&quot;: &quot;A String&quot;, # Status of the post. Only set for admin-level requests.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700178 &quot;etag&quot;: &quot;A String&quot;, # Etag of the resource.
179 &quot;kind&quot;: &quot;A String&quot;, # The kind of this entity. Always blogger#post.
180 &quot;readerComments&quot;: &quot;A String&quot;, # Comment control and display setting for readers of this post.
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700181 }</pre>
182</div>
183
184<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700185 <code class="details" id="list">list(blogId, startDate=None, fetchBodies=None, pageToken=None, maxResults=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700186 <pre>Lists posts.
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700187
188Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700189 blogId: string, A parameter (required)
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700190 startDate: string, A parameter
191 fetchBodies: boolean, A parameter
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700192 pageToken: string, A parameter
193 maxResults: integer, A parameter
Dan O'Mearadd494642020-05-01 07:42:23 -0700194 x__xgafv: string, V1 error format.
195 Allowed values
196 1 - v1 error format
197 2 - v2 error format
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700198
199Returns:
200 An object of the form:
201
202 {
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700203 &quot;nextPageToken&quot;: &quot;A String&quot;, # Pagination token to fetch the next page, if one exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700204 &quot;kind&quot;: &quot;A String&quot;, # The kind of this entity. Always blogger#postList.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700205 &quot;prevPageToken&quot;: &quot;A String&quot;, # Pagination token to fetch the previous page, if one exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700206 &quot;items&quot;: [ # The list of Posts for this Blog.
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700207 {
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700208 &quot;author&quot;: { # The author of this Post.
209 &quot;displayName&quot;: &quot;A String&quot;, # The display name.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700210 &quot;url&quot;: &quot;A String&quot;, # The URL of the creator&#x27;s Profile page.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700211 &quot;id&quot;: &quot;A String&quot;, # The identifier of the creator.
212 &quot;image&quot;: { # The creator&#x27;s avatar.
213 &quot;url&quot;: &quot;A String&quot;, # The creator&#x27;s avatar URL.
214 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700215 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700216 &quot;published&quot;: &quot;A String&quot;, # RFC 3339 date-time when this Post was published.
Bu Sun Kim65020912020-05-20 12:08:20 -0700217 &quot;images&quot;: [ # Display image for the Post.
Dan O'Mearadd494642020-05-01 07:42:23 -0700218 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700219 &quot;url&quot;: &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700220 },
221 ],
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700222 &quot;updated&quot;: &quot;A String&quot;, # RFC 3339 date-time when this Post was last updated.
223 &quot;labels&quot;: [ # The list of labels this Post was tagged with.
224 &quot;A String&quot;,
225 ],
226 &quot;customMetaData&quot;: &quot;A String&quot;, # The JSON meta-data for the Post.
227 &quot;titleLink&quot;: &quot;A String&quot;, # The title link URL, similar to atom&#x27;s related link.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700228 &quot;url&quot;: &quot;A String&quot;, # The URL where this Post is displayed.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700229 &quot;blog&quot;: { # Data about the blog containing this Post.
230 &quot;id&quot;: &quot;A String&quot;, # The identifier of the Blog that contains this Post.
231 },
232 &quot;location&quot;: { # The location for geotagged posts.
233 &quot;name&quot;: &quot;A String&quot;, # Location name.
234 &quot;lng&quot;: 3.14, # Location&#x27;s longitude.
235 &quot;span&quot;: &quot;A String&quot;, # Location&#x27;s viewport span. Can be used when rendering a map preview.
236 &quot;lat&quot;: 3.14, # Location&#x27;s latitude.
237 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700238 &quot;content&quot;: &quot;A String&quot;, # The content of the Post. May contain HTML markup.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700239 &quot;selfLink&quot;: &quot;A String&quot;, # The API REST URL to fetch this resource from.
240 &quot;replies&quot;: { # The container of comments on this Post.
241 &quot;totalItems&quot;: &quot;A String&quot;, # The count of comments on this post.
242 &quot;selfLink&quot;: &quot;A String&quot;, # The URL of the comments on this post.
243 &quot;items&quot;: [ # The List of Comments for this Post.
244 {
245 &quot;author&quot;: { # The author of this Comment.
246 &quot;displayName&quot;: &quot;A String&quot;, # The display name.
247 &quot;id&quot;: &quot;A String&quot;, # The identifier of the creator.
248 &quot;url&quot;: &quot;A String&quot;, # The URL of the creator&#x27;s Profile page.
249 &quot;image&quot;: { # The creator&#x27;s avatar.
250 &quot;url&quot;: &quot;A String&quot;, # The creator&#x27;s avatar URL.
251 },
252 },
253 &quot;content&quot;: &quot;A String&quot;, # The actual content of the comment. May include HTML markup.
254 &quot;id&quot;: &quot;A String&quot;, # The identifier for this resource.
255 &quot;updated&quot;: &quot;A String&quot;, # RFC 3339 date-time when this comment was last updated.
256 &quot;published&quot;: &quot;A String&quot;, # RFC 3339 date-time when this comment was published.
257 &quot;status&quot;: &quot;A String&quot;, # The status of the comment (only populated for admin users).
258 &quot;blog&quot;: { # Data about the blog containing this comment.
259 &quot;id&quot;: &quot;A String&quot;, # The identifier of the blog containing this comment.
260 },
261 &quot;kind&quot;: &quot;A String&quot;, # The kind of this entry. Always blogger#comment.
262 &quot;inReplyTo&quot;: { # Data about the comment this is in reply to.
263 &quot;id&quot;: &quot;A String&quot;, # The identified of the parent of this comment.
264 },
265 &quot;selfLink&quot;: &quot;A String&quot;, # The API REST URL to fetch this resource from.
266 &quot;post&quot;: { # Data about the post containing this comment.
267 &quot;id&quot;: &quot;A String&quot;, # The identifier of the post containing this comment.
268 },
269 },
270 ],
271 },
272 &quot;title&quot;: &quot;A String&quot;, # The title of the Post.
273 &quot;id&quot;: &quot;A String&quot;, # The identifier of this Post.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700274 &quot;status&quot;: &quot;A String&quot;, # Status of the post. Only set for admin-level requests.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700275 &quot;etag&quot;: &quot;A String&quot;, # Etag of the resource.
276 &quot;kind&quot;: &quot;A String&quot;, # The kind of this entity. Always blogger#post.
277 &quot;readerComments&quot;: &quot;A String&quot;, # Comment control and display setting for readers of this post.
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700278 },
279 ],
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700280 &quot;etag&quot;: &quot;A String&quot;, # Etag of the response.
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700281 }</pre>
282</div>
283
284<div class="method">
285 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
286 <pre>Retrieves the next page of results.
287
288Args:
289 previous_request: The request for the previous page. (required)
290 previous_response: The response from the request for the previous page. (required)
291
292Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700293 A request object that you can call &#x27;execute()&#x27; on to request the next
Sai Cheemalapatidf613972016-10-21 13:59:49 -0700294 page. Returns None if there are no more items in the collection.
295 </pre>
296</div>
297
298</body></html>