1<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 75<h1><a href="blogger_v3.html">Blogger API v3</a> . <a href="blogger_v3.blogs.html">blogs</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#get">get(blogId, maxPosts=None, view=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Gets a blog by id.</p> 83<p class="toc_element"> 84 <code><a href="#getByUrl">getByUrl(url, view=None, x__xgafv=None)</a></code></p> 85<p class="firstline">Gets a blog by url.</p> 86<p class="toc_element"> 87 <code><a href="#listByUser">listByUser(userId, fetchUserInfo=None, role=None, status=None, view=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Lists blogs by user.</p> 89<h3>Method Details</h3> 90<div class="method"> 91 <code class="details" id="close">close()</code> 92 <pre>Close httplib2 connections.</pre> 93</div> 94 95<div class="method"> 96 <code class="details" id="get">get(blogId, maxPosts=None, view=None, x__xgafv=None)</code> 97 <pre>Gets a blog by id. 98 99Args: 100 blogId: string, A parameter (required) 101 maxPosts: integer, A parameter 102 view: string, A parameter 103 Allowed values 104 VIEW_TYPE_UNSPECIFIED - 105 READER - 106 AUTHOR - 107 ADMIN - 108 x__xgafv: string, V1 error format. 109 Allowed values 110 1 - v1 error format 111 2 - v2 error format 112 113Returns: 114 An object of the form: 115 116 { 117 "customMetaData": "A String", # The JSON custom meta-data for the Blog. 118 "description": "A String", # The description of this blog. This is displayed underneath the title. 119 "id": "A String", # The identifier for this resource. 120 "kind": "A String", # The kind of this entry. Always blogger#blog. 121 "locale": { # The locale this Blog is set to. 122 "country": "A String", # The country this blog's locale is set to. 123 "language": "A String", # The language this blog is authored in. 124 "variant": "A String", # The language variant this blog is authored in. 125 }, 126 "name": "A String", # The name of this blog. This is displayed as the title. 127 "pages": { # The container of pages in this blog. 128 "selfLink": "A String", # The URL of the container for pages in this blog. 129 "totalItems": 42, # The count of pages in this blog. 130 }, 131 "posts": { # The container of posts in this blog. 132 "items": [ # The List of Posts for this Blog. 133 { 134 "author": { # The author of this Post. 135 "displayName": "A String", # The display name. 136 "id": "A String", # The identifier of the creator. 137 "image": { # The creator's avatar. 138 "url": "A String", # The creator's avatar URL. 139 }, 140 "url": "A String", # The URL of the creator's Profile page. 141 }, 142 "blog": { # Data about the blog containing this Post. 143 "id": "A String", # The identifier of the Blog that contains this Post. 144 }, 145 "content": "A String", # The content of the Post. May contain HTML markup. 146 "customMetaData": "A String", # The JSON meta-data for the Post. 147 "etag": "A String", # Etag of the resource. 148 "id": "A String", # The identifier of this Post. 149 "images": [ # Display image for the Post. 150 { 151 "url": "A String", 152 }, 153 ], 154 "kind": "A String", # The kind of this entity. Always blogger#post. 155 "labels": [ # The list of labels this Post was tagged with. 156 "A String", 157 ], 158 "location": { # The location for geotagged posts. 159 "lat": 3.14, # Location's latitude. 160 "lng": 3.14, # Location's longitude. 161 "name": "A String", # Location name. 162 "span": "A String", # Location's viewport span. Can be used when rendering a map preview. 163 }, 164 "published": "A String", # RFC 3339 date-time when this Post was published. 165 "readerComments": "A String", # Comment control and display setting for readers of this post. 166 "replies": { # The container of comments on this Post. 167 "items": [ # The List of Comments for this Post. 168 { 169 "author": { # The author of this Comment. 170 "displayName": "A String", # The display name. 171 "id": "A String", # The identifier of the creator. 172 "image": { # The creator's avatar. 173 "url": "A String", # The creator's avatar URL. 174 }, 175 "url": "A String", # The URL of the creator's Profile page. 176 }, 177 "blog": { # Data about the blog containing this comment. 178 "id": "A String", # The identifier of the blog containing this comment. 179 }, 180 "content": "A String", # The actual content of the comment. May include HTML markup. 181 "id": "A String", # The identifier for this resource. 182 "inReplyTo": { # Data about the comment this is in reply to. 183 "id": "A String", # The identified of the parent of this comment. 184 }, 185 "kind": "A String", # The kind of this entry. Always blogger#comment. 186 "post": { # Data about the post containing this comment. 187 "id": "A String", # The identifier of the post containing this comment. 188 }, 189 "published": "A String", # RFC 3339 date-time when this comment was published. 190 "selfLink": "A String", # The API REST URL to fetch this resource from. 191 "status": "A String", # The status of the comment (only populated for admin users). 192 "updated": "A String", # RFC 3339 date-time when this comment was last updated. 193 }, 194 ], 195 "selfLink": "A String", # The URL of the comments on this post. 196 "totalItems": "A String", # The count of comments on this post. 197 }, 198 "selfLink": "A String", # The API REST URL to fetch this resource from. 199 "status": "A String", # Status of the post. Only set for admin-level requests. 200 "title": "A String", # The title of the Post. 201 "titleLink": "A String", # The title link URL, similar to atom's related link. 202 "updated": "A String", # RFC 3339 date-time when this Post was last updated. 203 "url": "A String", # The URL where this Post is displayed. 204 }, 205 ], 206 "selfLink": "A String", # The URL of the container for posts in this blog. 207 "totalItems": 42, # The count of posts in this blog. 208 }, 209 "published": "A String", # RFC 3339 date-time when this blog was published. 210 "selfLink": "A String", # The API REST URL to fetch this resource from. 211 "status": "A String", # The status of the blog. 212 "updated": "A String", # RFC 3339 date-time when this blog was last updated. 213 "url": "A String", # The URL where this blog is published. 214}</pre> 215</div> 216 217<div class="method"> 218 <code class="details" id="getByUrl">getByUrl(url, view=None, x__xgafv=None)</code> 219 <pre>Gets a blog by url. 220 221Args: 222 url: string, A parameter (required) 223 view: string, A parameter 224 Allowed values 225 VIEW_TYPE_UNSPECIFIED - 226 READER - 227 AUTHOR - 228 ADMIN - 229 x__xgafv: string, V1 error format. 230 Allowed values 231 1 - v1 error format 232 2 - v2 error format 233 234Returns: 235 An object of the form: 236 237 { 238 "customMetaData": "A String", # The JSON custom meta-data for the Blog. 239 "description": "A String", # The description of this blog. This is displayed underneath the title. 240 "id": "A String", # The identifier for this resource. 241 "kind": "A String", # The kind of this entry. Always blogger#blog. 242 "locale": { # The locale this Blog is set to. 243 "country": "A String", # The country this blog's locale is set to. 244 "language": "A String", # The language this blog is authored in. 245 "variant": "A String", # The language variant this blog is authored in. 246 }, 247 "name": "A String", # The name of this blog. This is displayed as the title. 248 "pages": { # The container of pages in this blog. 249 "selfLink": "A String", # The URL of the container for pages in this blog. 250 "totalItems": 42, # The count of pages in this blog. 251 }, 252 "posts": { # The container of posts in this blog. 253 "items": [ # The List of Posts for this Blog. 254 { 255 "author": { # The author of this Post. 256 "displayName": "A String", # The display name. 257 "id": "A String", # The identifier of the creator. 258 "image": { # The creator's avatar. 259 "url": "A String", # The creator's avatar URL. 260 }, 261 "url": "A String", # The URL of the creator's Profile page. 262 }, 263 "blog": { # Data about the blog containing this Post. 264 "id": "A String", # The identifier of the Blog that contains this Post. 265 }, 266 "content": "A String", # The content of the Post. May contain HTML markup. 267 "customMetaData": "A String", # The JSON meta-data for the Post. 268 "etag": "A String", # Etag of the resource. 269 "id": "A String", # The identifier of this Post. 270 "images": [ # Display image for the Post. 271 { 272 "url": "A String", 273 }, 274 ], 275 "kind": "A String", # The kind of this entity. Always blogger#post. 276 "labels": [ # The list of labels this Post was tagged with. 277 "A String", 278 ], 279 "location": { # The location for geotagged posts. 280 "lat": 3.14, # Location's latitude. 281 "lng": 3.14, # Location's longitude. 282 "name": "A String", # Location name. 283 "span": "A String", # Location's viewport span. Can be used when rendering a map preview. 284 }, 285 "published": "A String", # RFC 3339 date-time when this Post was published. 286 "readerComments": "A String", # Comment control and display setting for readers of this post. 287 "replies": { # The container of comments on this Post. 288 "items": [ # The List of Comments for this Post. 289 { 290 "author": { # The author of this Comment. 291 "displayName": "A String", # The display name. 292 "id": "A String", # The identifier of the creator. 293 "image": { # The creator's avatar. 294 "url": "A String", # The creator's avatar URL. 295 }, 296 "url": "A String", # The URL of the creator's Profile page. 297 }, 298 "blog": { # Data about the blog containing this comment. 299 "id": "A String", # The identifier of the blog containing this comment. 300 }, 301 "content": "A String", # The actual content of the comment. May include HTML markup. 302 "id": "A String", # The identifier for this resource. 303 "inReplyTo": { # Data about the comment this is in reply to. 304 "id": "A String", # The identified of the parent of this comment. 305 }, 306 "kind": "A String", # The kind of this entry. Always blogger#comment. 307 "post": { # Data about the post containing this comment. 308 "id": "A String", # The identifier of the post containing this comment. 309 }, 310 "published": "A String", # RFC 3339 date-time when this comment was published. 311 "selfLink": "A String", # The API REST URL to fetch this resource from. 312 "status": "A String", # The status of the comment (only populated for admin users). 313 "updated": "A String", # RFC 3339 date-time when this comment was last updated. 314 }, 315 ], 316 "selfLink": "A String", # The URL of the comments on this post. 317 "totalItems": "A String", # The count of comments on this post. 318 }, 319 "selfLink": "A String", # The API REST URL to fetch this resource from. 320 "status": "A String", # Status of the post. Only set for admin-level requests. 321 "title": "A String", # The title of the Post. 322 "titleLink": "A String", # The title link URL, similar to atom's related link. 323 "updated": "A String", # RFC 3339 date-time when this Post was last updated. 324 "url": "A String", # The URL where this Post is displayed. 325 }, 326 ], 327 "selfLink": "A String", # The URL of the container for posts in this blog. 328 "totalItems": 42, # The count of posts in this blog. 329 }, 330 "published": "A String", # RFC 3339 date-time when this blog was published. 331 "selfLink": "A String", # The API REST URL to fetch this resource from. 332 "status": "A String", # The status of the blog. 333 "updated": "A String", # RFC 3339 date-time when this blog was last updated. 334 "url": "A String", # The URL where this blog is published. 335}</pre> 336</div> 337 338<div class="method"> 339 <code class="details" id="listByUser">listByUser(userId, fetchUserInfo=None, role=None, status=None, view=None, x__xgafv=None)</code> 340 <pre>Lists blogs by user. 341 342Args: 343 userId: string, A parameter (required) 344 fetchUserInfo: boolean, A parameter 345 role: string, A parameter (repeated) 346 Allowed values 347 VIEW_TYPE_UNSPECIFIED - 348 READER - 349 AUTHOR - 350 ADMIN - 351 status: string, Default value of status is LIVE. (repeated) 352 Allowed values 353 LIVE - 354 DELETED - 355 view: string, A parameter 356 Allowed values 357 VIEW_TYPE_UNSPECIFIED - 358 READER - 359 AUTHOR - 360 ADMIN - 361 x__xgafv: string, V1 error format. 362 Allowed values 363 1 - v1 error format 364 2 - v2 error format 365 366Returns: 367 An object of the form: 368 369 { 370 "blogUserInfos": [ # Admin level list of blog per-user information. 371 { 372 "blog": { # The Blog resource. 373 "customMetaData": "A String", # The JSON custom meta-data for the Blog. 374 "description": "A String", # The description of this blog. This is displayed underneath the title. 375 "id": "A String", # The identifier for this resource. 376 "kind": "A String", # The kind of this entry. Always blogger#blog. 377 "locale": { # The locale this Blog is set to. 378 "country": "A String", # The country this blog's locale is set to. 379 "language": "A String", # The language this blog is authored in. 380 "variant": "A String", # The language variant this blog is authored in. 381 }, 382 "name": "A String", # The name of this blog. This is displayed as the title. 383 "pages": { # The container of pages in this blog. 384 "selfLink": "A String", # The URL of the container for pages in this blog. 385 "totalItems": 42, # The count of pages in this blog. 386 }, 387 "posts": { # The container of posts in this blog. 388 "items": [ # The List of Posts for this Blog. 389 { 390 "author": { # The author of this Post. 391 "displayName": "A String", # The display name. 392 "id": "A String", # The identifier of the creator. 393 "image": { # The creator's avatar. 394 "url": "A String", # The creator's avatar URL. 395 }, 396 "url": "A String", # The URL of the creator's Profile page. 397 }, 398 "blog": { # Data about the blog containing this Post. 399 "id": "A String", # The identifier of the Blog that contains this Post. 400 }, 401 "content": "A String", # The content of the Post. May contain HTML markup. 402 "customMetaData": "A String", # The JSON meta-data for the Post. 403 "etag": "A String", # Etag of the resource. 404 "id": "A String", # The identifier of this Post. 405 "images": [ # Display image for the Post. 406 { 407 "url": "A String", 408 }, 409 ], 410 "kind": "A String", # The kind of this entity. Always blogger#post. 411 "labels": [ # The list of labels this Post was tagged with. 412 "A String", 413 ], 414 "location": { # The location for geotagged posts. 415 "lat": 3.14, # Location's latitude. 416 "lng": 3.14, # Location's longitude. 417 "name": "A String", # Location name. 418 "span": "A String", # Location's viewport span. Can be used when rendering a map preview. 419 }, 420 "published": "A String", # RFC 3339 date-time when this Post was published. 421 "readerComments": "A String", # Comment control and display setting for readers of this post. 422 "replies": { # The container of comments on this Post. 423 "items": [ # The List of Comments for this Post. 424 { 425 "author": { # The author of this Comment. 426 "displayName": "A String", # The display name. 427 "id": "A String", # The identifier of the creator. 428 "image": { # The creator's avatar. 429 "url": "A String", # The creator's avatar URL. 430 }, 431 "url": "A String", # The URL of the creator's Profile page. 432 }, 433 "blog": { # Data about the blog containing this comment. 434 "id": "A String", # The identifier of the blog containing this comment. 435 }, 436 "content": "A String", # The actual content of the comment. May include HTML markup. 437 "id": "A String", # The identifier for this resource. 438 "inReplyTo": { # Data about the comment this is in reply to. 439 "id": "A String", # The identified of the parent of this comment. 440 }, 441 "kind": "A String", # The kind of this entry. Always blogger#comment. 442 "post": { # Data about the post containing this comment. 443 "id": "A String", # The identifier of the post containing this comment. 444 }, 445 "published": "A String", # RFC 3339 date-time when this comment was published. 446 "selfLink": "A String", # The API REST URL to fetch this resource from. 447 "status": "A String", # The status of the comment (only populated for admin users). 448 "updated": "A String", # RFC 3339 date-time when this comment was last updated. 449 }, 450 ], 451 "selfLink": "A String", # The URL of the comments on this post. 452 "totalItems": "A String", # The count of comments on this post. 453 }, 454 "selfLink": "A String", # The API REST URL to fetch this resource from. 455 "status": "A String", # Status of the post. Only set for admin-level requests. 456 "title": "A String", # The title of the Post. 457 "titleLink": "A String", # The title link URL, similar to atom's related link. 458 "updated": "A String", # RFC 3339 date-time when this Post was last updated. 459 "url": "A String", # The URL where this Post is displayed. 460 }, 461 ], 462 "selfLink": "A String", # The URL of the container for posts in this blog. 463 "totalItems": 42, # The count of posts in this blog. 464 }, 465 "published": "A String", # RFC 3339 date-time when this blog was published. 466 "selfLink": "A String", # The API REST URL to fetch this resource from. 467 "status": "A String", # The status of the blog. 468 "updated": "A String", # RFC 3339 date-time when this blog was last updated. 469 "url": "A String", # The URL where this blog is published. 470 }, 471 "blog_user_info": { # Information about a User for the Blog. 472 "blogId": "A String", # ID of the Blog resource. 473 "hasAdminAccess": True or False, # True if the user has Admin level access to the blog. 474 "kind": "A String", # The kind of this entity. Always blogger#blogPerUserInfo. 475 "photosAlbumKey": "A String", # The Photo Album Key for the user when adding photos to the blog. 476 "role": "A String", # Access permissions that the user has for the blog (ADMIN, AUTHOR, or READER). 477 "userId": "A String", # ID of the User. 478 }, 479 "kind": "A String", # The kind of this entity. Always blogger#blogUserInfo. 480 }, 481 ], 482 "items": [ # The list of Blogs this user has Authorship or Admin rights over. 483 { 484 "customMetaData": "A String", # The JSON custom meta-data for the Blog. 485 "description": "A String", # The description of this blog. This is displayed underneath the title. 486 "id": "A String", # The identifier for this resource. 487 "kind": "A String", # The kind of this entry. Always blogger#blog. 488 "locale": { # The locale this Blog is set to. 489 "country": "A String", # The country this blog's locale is set to. 490 "language": "A String", # The language this blog is authored in. 491 "variant": "A String", # The language variant this blog is authored in. 492 }, 493 "name": "A String", # The name of this blog. This is displayed as the title. 494 "pages": { # The container of pages in this blog. 495 "selfLink": "A String", # The URL of the container for pages in this blog. 496 "totalItems": 42, # The count of pages in this blog. 497 }, 498 "posts": { # The container of posts in this blog. 499 "items": [ # The List of Posts for this Blog. 500 { 501 "author": { # The author of this Post. 502 "displayName": "A String", # The display name. 503 "id": "A String", # The identifier of the creator. 504 "image": { # The creator's avatar. 505 "url": "A String", # The creator's avatar URL. 506 }, 507 "url": "A String", # The URL of the creator's Profile page. 508 }, 509 "blog": { # Data about the blog containing this Post. 510 "id": "A String", # The identifier of the Blog that contains this Post. 511 }, 512 "content": "A String", # The content of the Post. May contain HTML markup. 513 "customMetaData": "A String", # The JSON meta-data for the Post. 514 "etag": "A String", # Etag of the resource. 515 "id": "A String", # The identifier of this Post. 516 "images": [ # Display image for the Post. 517 { 518 "url": "A String", 519 }, 520 ], 521 "kind": "A String", # The kind of this entity. Always blogger#post. 522 "labels": [ # The list of labels this Post was tagged with. 523 "A String", 524 ], 525 "location": { # The location for geotagged posts. 526 "lat": 3.14, # Location's latitude. 527 "lng": 3.14, # Location's longitude. 528 "name": "A String", # Location name. 529 "span": "A String", # Location's viewport span. Can be used when rendering a map preview. 530 }, 531 "published": "A String", # RFC 3339 date-time when this Post was published. 532 "readerComments": "A String", # Comment control and display setting for readers of this post. 533 "replies": { # The container of comments on this Post. 534 "items": [ # The List of Comments for this Post. 535 { 536 "author": { # The author of this Comment. 537 "displayName": "A String", # The display name. 538 "id": "A String", # The identifier of the creator. 539 "image": { # The creator's avatar. 540 "url": "A String", # The creator's avatar URL. 541 }, 542 "url": "A String", # The URL of the creator's Profile page. 543 }, 544 "blog": { # Data about the blog containing this comment. 545 "id": "A String", # The identifier of the blog containing this comment. 546 }, 547 "content": "A String", # The actual content of the comment. May include HTML markup. 548 "id": "A String", # The identifier for this resource. 549 "inReplyTo": { # Data about the comment this is in reply to. 550 "id": "A String", # The identified of the parent of this comment. 551 }, 552 "kind": "A String", # The kind of this entry. Always blogger#comment. 553 "post": { # Data about the post containing this comment. 554 "id": "A String", # The identifier of the post containing this comment. 555 }, 556 "published": "A String", # RFC 3339 date-time when this comment was published. 557 "selfLink": "A String", # The API REST URL to fetch this resource from. 558 "status": "A String", # The status of the comment (only populated for admin users). 559 "updated": "A String", # RFC 3339 date-time when this comment was last updated. 560 }, 561 ], 562 "selfLink": "A String", # The URL of the comments on this post. 563 "totalItems": "A String", # The count of comments on this post. 564 }, 565 "selfLink": "A String", # The API REST URL to fetch this resource from. 566 "status": "A String", # Status of the post. Only set for admin-level requests. 567 "title": "A String", # The title of the Post. 568 "titleLink": "A String", # The title link URL, similar to atom's related link. 569 "updated": "A String", # RFC 3339 date-time when this Post was last updated. 570 "url": "A String", # The URL where this Post is displayed. 571 }, 572 ], 573 "selfLink": "A String", # The URL of the container for posts in this blog. 574 "totalItems": 42, # The count of posts in this blog. 575 }, 576 "published": "A String", # RFC 3339 date-time when this blog was published. 577 "selfLink": "A String", # The API REST URL to fetch this resource from. 578 "status": "A String", # The status of the blog. 579 "updated": "A String", # RFC 3339 date-time when this blog was last updated. 580 "url": "A String", # The URL where this blog is published. 581 }, 582 ], 583 "kind": "A String", # The kind of this entity. Always blogger#blogList. 584}</pre> 585</div> 586 587</body></html>