# Blogger API . posts

## Instance Methods

Delete a post by ID.

Get a post by ID.

Retrieve a Post by Path.

Add a post.

Retrieves a list of posts, possibly filtered.

Retrieves the next page of results.

Update a post. This method supports patch semantics.

Publishes a draft post, optionally at the specific time of the given publishDate parameter.

Revert a published or scheduled post to draft state.

Search for a post.

Update a post.

### Method Details

`delete(blogId, postId)`

    Delete a post by ID.

    Args:
      blogId: string, The ID of the Blog. (required)
      postId: string, The ID of the Post. (required)

`get(blogId, postId, maxComments=None, fetchImages=None, fetchBody=None, view=None)`

    Get a post by ID.

    Args:
      blogId: string, ID of the blog to fetch the post from. (required)
      postId: string, The ID of the post (required)
      maxComments: integer, Maximum number of comments to pull back on a post.
      fetchImages: boolean, Whether image URL metadata for each post is included (default: false).
      fetchBody: boolean, Whether the body content of the post is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.
      view: string, Access level with which to view the returned result. Note that some fields require elevated access.
        Allowed values
          ADMIN - Admin level detail
          AUTHOR - Author level detail
          READER - Reader level detail

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`getByPath(blogId, path, maxComments=None, view=None)`

    Retrieve a Post by Path.

    Args:
      blogId: string, ID of the blog to fetch the post from. (required)
      path: string, Path of the Post to retrieve. (required)
      maxComments: integer, Maximum number of comments to pull back on a post.
      view: string, Access level with which to view the returned result. Note that some fields require elevated access.
        Allowed values
          ADMIN - Admin level detail
          AUTHOR - Author level detail
          READER - Reader level detail

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`insert(blogId, body, isDraft=None, fetchImages=None, fetchBody=None)`

    Add a post.

    Args:
      blogId: string, ID of the blog to add the post to. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
      "status": "A String", # Status of the post. Only set for admin-level requests
      "content": "A String", # The content of the Post. May contain HTML markup.
      "kind": "blogger#post", # The kind of this entity. Always blogger#post
      "titleLink": "A String", # The title link URL, similar to atom's related link.
      "author": { # The author of this Post.
        "url": "A String", # The URL of the Post creator's Profile page.
        "image": { # The Post author's avatar.
          "url": "A String", # The Post author's avatar URL.
        },
        "displayName": "A String", # The display name.
        "id": "A String", # The identifier of the Post creator.
      },
      "replies": { # The container of comments on this Post.
        "totalItems": "A String", # The count of comments on this post.
        "items": [ # The List of Comments for this Post.
          {
            "status": "A String", # The status of the comment (only populated for admin users)
            "content": "A String", # The actual content of the comment. May include HTML markup.
            "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
            "inReplyTo": { # Data about the comment this is in reply to.
              "id": "A String", # The identified of the parent of this comment.
            },
            "author": { # The author of this Comment.
              "url": "A String", # The URL of the Comment creator's Profile page.
              "image": { # The comment creator's avatar.
                "url": "A String", # The comment creator's avatar URL.
              },
              "displayName": "A String", # The display name.
              "id": "A String", # The identifier of the Comment creator.
            },
            "updated": "A String", # RFC 3339 date-time when this comment was last updated.
            "blog": { # Data about the blog containing this comment.
              "id": "A String", # The identifier of the blog containing this comment.
            },
            "published": "A String", # RFC 3339 date-time when this comment was published.
            "post": { # Data about the post containing this comment.
              "id": "A String", # The identifier of the post containing this comment.
            },
            "id": "A String", # The identifier for this resource.
            "selfLink": "A String", # The API REST URL to fetch this resource from.
          },
        ],
        "selfLink": "A String", # The URL of the comments on this post.
      },
      "readerComments": "A String", # Comment control and display setting for readers of this post.
      "labels": [ # The list of labels this Post was tagged with.
        "A String",
      ],
      "customMetaData": "A String", # The JSON meta-data for the Post.
      "updated": "A String", # RFC 3339 date-time when this Post was last updated.
      "blog": { # Data about the blog containing this Post.
        "id": "A String", # The identifier of the Blog that contains this Post.
      },
      "url": "A String", # The URL where this Post is displayed.
      "etag": "A String", # Etag of the resource.
      "location": { # The location for geotagged posts.
        "lat": 3.14, # Location's latitude.
        "lng": 3.14, # Location's longitude.
        "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
        "name": "A String", # Location name.
      },
      "published": "A String", # RFC 3339 date-time when this Post was published.
      "images": [ # Display image for the Post.
        {
          "url": "A String",
        },
      ],
      "title": "A String", # The title of the Post.
      "id": "A String", # The identifier of this Post.
      "selfLink": "A String", # The API REST URL to fetch this resource from.
    }

      isDraft: boolean, Whether to create the post as a draft (default: false).
      fetchImages: boolean, Whether image URL metadata for each post is included in the returned result (default: false).
      fetchBody: boolean, Whether the body content of the post is included with the result (default: true).

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`list(blogId, orderBy=None, startDate=None, endDate=None, labels=None, pageToken=None, status=None, maxResults=None, fetchBodies=None, fetchImages=None, view=None)`

    Retrieves a list of posts, possibly filtered.

    Args:
      blogId: string, ID of the blog to fetch posts from. (required)
      orderBy: string, Sort search results
        Allowed values
          published - Order by the date the post was published
          updated - Order by the date the post was last updated
      startDate: string, Earliest post date to fetch, a date-time with RFC 3339 formatting.
      endDate: string, Latest post date to fetch, a date-time with RFC 3339 formatting.
      labels: string, Comma-separated list of labels to search for.
      pageToken: string, Continuation token if the request is paged.
      status: string, Statuses to include in the results. (repeated)
        Allowed values
          draft - Draft (non-published) posts.
          live - Published posts
          scheduled - Posts that are scheduled to publish in the future.
      maxResults: integer, Maximum number of posts to fetch.
      fetchBodies: boolean, Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.
      fetchImages: boolean, Whether image URL metadata for each post is included.
      view: string, Access level with which to view the returned result. Note that some fields require escalated access.
        Allowed values
          ADMIN - Admin level detail
          AUTHOR - Author level detail
          READER - Reader level detail

    Returns:
      An object of the form:

        {
        "nextPageToken": "A String", # Pagination token to fetch the next page, if one exists.
        "items": [ # The list of Posts for this Blog.
          {
            "status": "A String", # Status of the post. Only set for admin-level requests
            "content": "A String", # The content of the Post. May contain HTML markup.
            "kind": "blogger#post", # The kind of this entity. Always blogger#post
            "titleLink": "A String", # The title link URL, similar to atom's related link.
            "author": { # The author of this Post.
              "url": "A String", # The URL of the Post creator's Profile page.
              "image": { # The Post author's avatar.
                "url": "A String", # The Post author's avatar URL.
              },
              "displayName": "A String", # The display name.
              "id": "A String", # The identifier of the Post creator.
            },
            "replies": { # The container of comments on this Post.
              "totalItems": "A String", # The count of comments on this post.
              "items": [ # The List of Comments for this Post.
                {
                  "status": "A String", # The status of the comment (only populated for admin users)
                  "content": "A String", # The actual content of the comment. May include HTML markup.
                  "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
                  "inReplyTo": { # Data about the comment this is in reply to.
                    "id": "A String", # The identified of the parent of this comment.
                  },
                  "author": { # The author of this Comment.
                    "url": "A String", # The URL of the Comment creator's Profile page.
                    "image": { # The comment creator's avatar.
                      "url": "A String", # The comment creator's avatar URL.
                    },
                    "displayName": "A String", # The display name.
                    "id": "A String", # The identifier of the Comment creator.
                  },
                  "updated": "A String", # RFC 3339 date-time when this comment was last updated.
                  "blog": { # Data about the blog containing this comment.
                    "id": "A String", # The identifier of the blog containing this comment.
                  },
                  "published": "A String", # RFC 3339 date-time when this comment was published.
                  "post": { # Data about the post containing this comment.
                    "id": "A String", # The identifier of the post containing this comment.
                  },
                  "id": "A String", # The identifier for this resource.
                  "selfLink": "A String", # The API REST URL to fetch this resource from.
                },
              ],
              "selfLink": "A String", # The URL of the comments on this post.
            },
            "readerComments": "A String", # Comment control and display setting for readers of this post.
            "labels": [ # The list of labels this Post was tagged with.
              "A String",
            ],
            "customMetaData": "A String", # The JSON meta-data for the Post.
            "updated": "A String", # RFC 3339 date-time when this Post was last updated.
            "blog": { # Data about the blog containing this Post.
              "id": "A String", # The identifier of the Blog that contains this Post.
            },
            "url": "A String", # The URL where this Post is displayed.
            "etag": "A String", # Etag of the resource.
            "location": { # The location for geotagged posts.
              "lat": 3.14, # Location's latitude.
              "lng": 3.14, # Location's longitude.
              "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
              "name": "A String", # Location name.
            },
            "published": "A String", # RFC 3339 date-time when this Post was published.
            "images": [ # Display image for the Post.
              {
                "url": "A String",
              },
            ],
            "title": "A String", # The title of the Post.
            "id": "A String", # The identifier of this Post.
            "selfLink": "A String", # The API REST URL to fetch this resource from.
          },
        ],
        "kind": "blogger#postList", # The kind of this entity. Always blogger#postList
        "etag": "A String", # Etag of the response.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(blogId, postId, body, maxComments=None, revert=None, publish=None, fetchImages=None, fetchBody=None)`

    Update a post. This method supports patch semantics.

    Args:
      blogId: string, The ID of the Blog. (required)
      postId: string, The ID of the Post. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
      "status": "A String", # Status of the post. Only set for admin-level requests
      "content": "A String", # The content of the Post. May contain HTML markup.
      "kind": "blogger#post", # The kind of this entity. Always blogger#post
      "titleLink": "A String", # The title link URL, similar to atom's related link.
      "author": { # The author of this Post.
        "url": "A String", # The URL of the Post creator's Profile page.
        "image": { # The Post author's avatar.
          "url": "A String", # The Post author's avatar URL.
        },
        "displayName": "A String", # The display name.
        "id": "A String", # The identifier of the Post creator.
      },
      "replies": { # The container of comments on this Post.
        "totalItems": "A String", # The count of comments on this post.
        "items": [ # The List of Comments for this Post.
          {
            "status": "A String", # The status of the comment (only populated for admin users)
            "content": "A String", # The actual content of the comment. May include HTML markup.
            "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
            "inReplyTo": { # Data about the comment this is in reply to.
              "id": "A String", # The identified of the parent of this comment.
            },
            "author": { # The author of this Comment.
              "url": "A String", # The URL of the Comment creator's Profile page.
              "image": { # The comment creator's avatar.
                "url": "A String", # The comment creator's avatar URL.
              },
              "displayName": "A String", # The display name.
              "id": "A String", # The identifier of the Comment creator.
            },
            "updated": "A String", # RFC 3339 date-time when this comment was last updated.
            "blog": { # Data about the blog containing this comment.
              "id": "A String", # The identifier of the blog containing this comment.
            },
            "published": "A String", # RFC 3339 date-time when this comment was published.
            "post": { # Data about the post containing this comment.
              "id": "A String", # The identifier of the post containing this comment.
            },
            "id": "A String", # The identifier for this resource.
            "selfLink": "A String", # The API REST URL to fetch this resource from.
          },
        ],
        "selfLink": "A String", # The URL of the comments on this post.
      },
      "readerComments": "A String", # Comment control and display setting for readers of this post.
      "labels": [ # The list of labels this Post was tagged with.
        "A String",
      ],
      "customMetaData": "A String", # The JSON meta-data for the Post.
      "updated": "A String", # RFC 3339 date-time when this Post was last updated.
      "blog": { # Data about the blog containing this Post.
        "id": "A String", # The identifier of the Blog that contains this Post.
      },
      "url": "A String", # The URL where this Post is displayed.
      "etag": "A String", # Etag of the resource.
      "location": { # The location for geotagged posts.
        "lat": 3.14, # Location's latitude.
        "lng": 3.14, # Location's longitude.
        "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
        "name": "A String", # Location name.
      },
      "published": "A String", # RFC 3339 date-time when this Post was published.
      "images": [ # Display image for the Post.
        {
          "url": "A String",
        },
      ],
      "title": "A String", # The title of the Post.
      "id": "A String", # The identifier of this Post.
      "selfLink": "A String", # The API REST URL to fetch this resource from.
    }

      maxComments: integer, Maximum number of comments to retrieve with the returned post.
      revert: boolean, Whether a revert action should be performed when the post is updated (default: false).
      publish: boolean, Whether a publish action should be performed when the post is updated (default: false).
      fetchImages: boolean, Whether image URL metadata for each post is included in the returned result (default: false).
      fetchBody: boolean, Whether the body content of the post is included with the result (default: true).

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`publish(blogId, postId, publishDate=None)`

    Publishes a draft post, optionally at the specific time of the given publishDate parameter.

    Args:
      blogId: string, The ID of the Blog. (required)
      postId: string, The ID of the Post. (required)
      publishDate: string, Optional date and time to schedule the publishing of the Blog. If no publishDate parameter is given, the post is either published at the a previously saved schedule date (if present), or the current time. If a future date is given, the post will be scheduled to be published.

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`revert(blogId, postId)`

    Revert a published or scheduled post to draft state.

    Args:
      blogId: string, The ID of the Blog. (required)
      postId: string, The ID of the Post. (required)

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }

`search(blogId, q, orderBy=None, fetchBodies=None)`

    Search for a post.

    Args:
      blogId: string, ID of the blog to fetch the post from. (required)
      q: string, Query terms to search this blog for matching posts. (required)
      orderBy: string, Sort search results
        Allowed values
          published - Order by the date the post was published
          updated - Order by the date the post was last updated
      fetchBodies: boolean, Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.

    Returns:
      An object of the form:

        {
        "nextPageToken": "A String", # Pagination token to fetch the next page, if one exists.
        "items": [ # The list of Posts for this Blog.
          {
            "status": "A String", # Status of the post. Only set for admin-level requests
            "content": "A String", # The content of the Post. May contain HTML markup.
            "kind": "blogger#post", # The kind of this entity. Always blogger#post
            "titleLink": "A String", # The title link URL, similar to atom's related link.
            "author": { # The author of this Post.
              "url": "A String", # The URL of the Post creator's Profile page.
              "image": { # The Post author's avatar.
                "url": "A String", # The Post author's avatar URL.
              },
              "displayName": "A String", # The display name.
              "id": "A String", # The identifier of the Post creator.
            },
            "replies": { # The container of comments on this Post.
              "totalItems": "A String", # The count of comments on this post.
              "items": [ # The List of Comments for this Post.
                {
                  "status": "A String", # The status of the comment (only populated for admin users)
                  "content": "A String", # The actual content of the comment. May include HTML markup.
                  "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
                  "inReplyTo": { # Data about the comment this is in reply to.
                    "id": "A String", # The identified of the parent of this comment.
                  },
                  "author": { # The author of this Comment.
                    "url": "A String", # The URL of the Comment creator's Profile page.
                    "image": { # The comment creator's avatar.
                      "url": "A String", # The comment creator's avatar URL.
                    },
                    "displayName": "A String", # The display name.
                    "id": "A String", # The identifier of the Comment creator.
                  },
                  "updated": "A String", # RFC 3339 date-time when this comment was last updated.
                  "blog": { # Data about the blog containing this comment.
                    "id": "A String", # The identifier of the blog containing this comment.
                  },
                  "published": "A String", # RFC 3339 date-time when this comment was published.
                  "post": { # Data about the post containing this comment.
                    "id": "A String", # The identifier of the post containing this comment.
                  },
                  "id": "A String", # The identifier for this resource.
                  "selfLink": "A String", # The API REST URL to fetch this resource from.
                },
              ],
              "selfLink": "A String", # The URL of the comments on this post.
            },
            "readerComments": "A String", # Comment control and display setting for readers of this post.
            "labels": [ # The list of labels this Post was tagged with.
              "A String",
            ],
            "customMetaData": "A String", # The JSON meta-data for the Post.
            "updated": "A String", # RFC 3339 date-time when this Post was last updated.
            "blog": { # Data about the blog containing this Post.
              "id": "A String", # The identifier of the Blog that contains this Post.
            },
            "url": "A String", # The URL where this Post is displayed.
            "etag": "A String", # Etag of the resource.
            "location": { # The location for geotagged posts.
              "lat": 3.14, # Location's latitude.
              "lng": 3.14, # Location's longitude.
              "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
              "name": "A String", # Location name.
            },
            "published": "A String", # RFC 3339 date-time when this Post was published.
            "images": [ # Display image for the Post.
              {
                "url": "A String",
              },
            ],
            "title": "A String", # The title of the Post.
            "id": "A String", # The identifier of this Post.
            "selfLink": "A String", # The API REST URL to fetch this resource from.
          },
        ],
        "kind": "blogger#postList", # The kind of this entity. Always blogger#postList
        "etag": "A String", # Etag of the response.
      }

`update(blogId, postId, body, maxComments=None, revert=None, publish=None, fetchImages=None, fetchBody=None)`

    Update a post.

    Args:
      blogId: string, The ID of the Blog. (required)
      postId: string, The ID of the Post. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
      "status": "A String", # Status of the post. Only set for admin-level requests
      "content": "A String", # The content of the Post. May contain HTML markup.
      "kind": "blogger#post", # The kind of this entity. Always blogger#post
      "titleLink": "A String", # The title link URL, similar to atom's related link.
      "author": { # The author of this Post.
        "url": "A String", # The URL of the Post creator's Profile page.
        "image": { # The Post author's avatar.
          "url": "A String", # The Post author's avatar URL.
        },
        "displayName": "A String", # The display name.
        "id": "A String", # The identifier of the Post creator.
      },
      "replies": { # The container of comments on this Post.
        "totalItems": "A String", # The count of comments on this post.
        "items": [ # The List of Comments for this Post.
          {
            "status": "A String", # The status of the comment (only populated for admin users)
            "content": "A String", # The actual content of the comment. May include HTML markup.
            "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
            "inReplyTo": { # Data about the comment this is in reply to.
              "id": "A String", # The identified of the parent of this comment.
            },
            "author": { # The author of this Comment.
              "url": "A String", # The URL of the Comment creator's Profile page.
              "image": { # The comment creator's avatar.
                "url": "A String", # The comment creator's avatar URL.
              },
              "displayName": "A String", # The display name.
              "id": "A String", # The identifier of the Comment creator.
            },
            "updated": "A String", # RFC 3339 date-time when this comment was last updated.
            "blog": { # Data about the blog containing this comment.
              "id": "A String", # The identifier of the blog containing this comment.
            },
            "published": "A String", # RFC 3339 date-time when this comment was published.
            "post": { # Data about the post containing this comment.
              "id": "A String", # The identifier of the post containing this comment.
            },
            "id": "A String", # The identifier for this resource.
            "selfLink": "A String", # The API REST URL to fetch this resource from.
          },
        ],
        "selfLink": "A String", # The URL of the comments on this post.
      },
      "readerComments": "A String", # Comment control and display setting for readers of this post.
      "labels": [ # The list of labels this Post was tagged with.
        "A String",
      ],
      "customMetaData": "A String", # The JSON meta-data for the Post.
      "updated": "A String", # RFC 3339 date-time when this Post was last updated.
      "blog": { # Data about the blog containing this Post.
        "id": "A String", # The identifier of the Blog that contains this Post.
      },
      "url": "A String", # The URL where this Post is displayed.
      "etag": "A String", # Etag of the resource.
      "location": { # The location for geotagged posts.
        "lat": 3.14, # Location's latitude.
        "lng": 3.14, # Location's longitude.
        "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
        "name": "A String", # Location name.
      },
      "published": "A String", # RFC 3339 date-time when this Post was published.
      "images": [ # Display image for the Post.
        {
          "url": "A String",
        },
      ],
      "title": "A String", # The title of the Post.
      "id": "A String", # The identifier of this Post.
      "selfLink": "A String", # The API REST URL to fetch this resource from.
    }

      maxComments: integer, Maximum number of comments to retrieve with the returned post.
      revert: boolean, Whether a revert action should be performed when the post is updated (default: false).
      publish: boolean, Whether a publish action should be performed when the post is updated (default: false).
      fetchImages: boolean, Whether image URL metadata for each post is included in the returned result (default: false).
      fetchBody: boolean, Whether the body content of the post is included with the result (default: true).

    Returns:
      An object of the form:

        {
        "status": "A String", # Status of the post. Only set for admin-level requests
        "content": "A String", # The content of the Post. May contain HTML markup.
        "kind": "blogger#post", # The kind of this entity. Always blogger#post
        "titleLink": "A String", # The title link URL, similar to atom's related link.
        "author": { # The author of this Post.
          "url": "A String", # The URL of the Post creator's Profile page.
          "image": { # The Post author's avatar.
            "url": "A String", # The Post author's avatar URL.
          },
          "displayName": "A String", # The display name.
          "id": "A String", # The identifier of the Post creator.
        },
        "replies": { # The container of comments on this Post.
          "totalItems": "A String", # The count of comments on this post.
          "items": [ # The List of Comments for this Post.
            {
              "status": "A String", # The status of the comment (only populated for admin users)
              "content": "A String", # The actual content of the comment. May include HTML markup.
              "kind": "blogger#comment", # The kind of this entry. Always blogger#comment
              "inReplyTo": { # Data about the comment this is in reply to.
                "id": "A String", # The identified of the parent of this comment.
              },
              "author": { # The author of this Comment.
                "url": "A String", # The URL of the Comment creator's Profile page.
                "image": { # The comment creator's avatar.
                  "url": "A String", # The comment creator's avatar URL.
                },
                "displayName": "A String", # The display name.
                "id": "A String", # The identifier of the Comment creator.
              },
              "updated": "A String", # RFC 3339 date-time when this comment was last updated.
              "blog": { # Data about the blog containing this comment.
                "id": "A String", # The identifier of the blog containing this comment.
              },
              "published": "A String", # RFC 3339 date-time when this comment was published.
              "post": { # Data about the post containing this comment.
                "id": "A String", # The identifier of the post containing this comment.
              },
              "id": "A String", # The identifier for this resource.
              "selfLink": "A String", # The API REST URL to fetch this resource from.
            },
          ],
          "selfLink": "A String", # The URL of the comments on this post.
        },
        "readerComments": "A String", # Comment control and display setting for readers of this post.
        "labels": [ # The list of labels this Post was tagged with.
          "A String",
        ],
        "customMetaData": "A String", # The JSON meta-data for the Post.
        "updated": "A String", # RFC 3339 date-time when this Post was last updated.
        "blog": { # Data about the blog containing this Post.
          "id": "A String", # The identifier of the Blog that contains this Post.
        },
        "url": "A String", # The URL where this Post is displayed.
        "etag": "A String", # Etag of the resource.
        "location": { # The location for geotagged posts.
          "lat": 3.14, # Location's latitude.
          "lng": 3.14, # Location's longitude.
          "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
          "name": "A String", # Location name.
        },
        "published": "A String", # RFC 3339 date-time when this Post was published.
        "images": [ # Display image for the Post.
          {
            "url": "A String",
          },
        ],
        "title": "A String", # The title of the Post.
        "id": "A String", # The identifier of this Post.
        "selfLink": "A String", # The API REST URL to fetch this resource from.
      }