AI-generated Key Takeaways
-
A posts resource contains the HTML content and metadata of a blog post.
-
The resource representation includes details such as post ID, blog information, publication and update times, URL, title, content, author details, comment information, labels, location data, and status.
-
Several methods are available for working with posts, including retrieving lists of posts, getting individual posts, searching, inserting, deleting, updating, publishing, and reverting posts.
A posts resource contain the HTML content of a blog post, along with post metadata.
For a list of methods for this resource, see the end of this page.
Resource representations
{ "kind" : "blogger#post" , "id" : string , "blog" : { "id" : string } , "published" : datetime , "updated" : datetime , "url" : string , "selfLink" : string , "title" : string , "titleLink" : string , "content" : string , "images" : [ { "url" : string } ], "author" : { "id" : string , "displayName" : string , "url" : string , "image" : { "url" : string } } , "replies" : { "totalItems" : long , "selfLink" : string , "items" : [ comments Resource ] } , "labels" : [ string ], "location" : { "name" : string , "lat" : double , "lng" : double , "span" : string } , "status" : string }
| Property name | Value | Description | Notes |
|---|---|---|---|
kind
|
string
|
The kind of this entity. Always blogger#post
. |
|
id
|
string
|
The ID of this post. | |
blog
|
object
|
Data about the blog containing this post. | |
blog.
id
|
string
|
The ID of the blog that contains this post. | |
published
|
datetime
|
RFC 3339
date-time
when this post was published. |
|
updated
|
datetime
|
RFC 3339
date-time
when this post was last updated. |
|
url
|
string
|
The URL where this post is displayed. | |
selfLink
|
string
|
The Blogger API URL to fetch this resource from. | |
title
|
string
|
The title of the post. | |
content
|
string
|
The content of the post. Can contain HTML markup. | |
author
|
object
|
The author of this post. | |
author.
id
|
string
|
The ID of the post creator. | |
author.
displayName
|
string
|
The post creator's display name. | |
author.
url
|
string
|
The URL of the post creator's profile page. | |
author.
image
|
object
|
The post creator's avatar. | |
author.image.
url
|
string
|
The post creator's avatar URL. | |
replies
|
object
|
The container for this post's comments. | |
replies.
totalItems
|
long
|
The total number of comments on this post. | |
replies.
selfLink
|
string
|
The Blogger API URL of to retrieve the comments for this post. | |
labels[]
|
list
|
The list of labels this post was tagged with. | |
replies.
items[]
|
list
|
The list of comments for this post. | |
location
|
object
|
The location, if this post is geotagged. | |
location.
name
|
string
|
Location name. | |
location.
lat
|
double
|
Location's latitude. | |
location.
lng
|
double
|
Location's longitude. | |
location.
span
|
string
|
Location's viewport span. Can be used when rendering a map preview. | |
titleLink
|
string
|
The title link URL, similar to atom's related link. | |
images[]
|
list
|
Display image for the Post. | |
images[].
url
|
string
|
||
status
|
string
|
Status of the post. Only set for admin-level requests |
Methods
You can retrieve the list of posts for a blog using the list method, and retrieve an individual post using the get method.
- list
- Retrieves a list of posts.
- get
- Retrieves one post by post ID.
- search
- Searches for a post that matches the given query terms.
- insert
- Adds a post.
- delete
- Deletes a post by ID.
- getByPath
- Retrieves a post by path.
- patch
- Updates a post. This method supports patch semantics .
- update
- Updates a post.
- publish
- Publish a draft post.
- revert
- Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content.
