AI-generated Key Takeaways
-
A blog is the root data class for the Blogger API and contains posts and pages, with posts also containing comments.
-
Resource representations for a blog include properties like kind, id, name, description, published date, updated date, URL, selfLink, and containers for posts and pages, as well as locale information and custom metadata.
-
Methods available for interacting with blogs include retrieving a blog by ID, retrieving a blog by URL, and retrieving a list of blogs by user.
A blog is the root data class for the Blogger API. Each blog has a series of posts and pages , and each post has a series of comments .
For a list of methods for this resource, see the end of this page.
Resource representations
{
"kind" : "blogger#blog" ,
"id" : value ,
"name" : value ,
"description" : value ,
"published" : value ,
"updated" : value ,
"url" : value ,
"selfLink" : value ,
"posts" : {
"totalItems" : value ,
"selfLink" : value
} ,
"pages" : {
"totalItems" : value ,
"selfLink" : value
} ,
"locale" : {
"language" : value ,
"country" : value ,
"variant" : value
}
}
| Property name | Value | Description | Notes |
|---|---|---|---|
kind
|
string
|
The kind of this entry. Always blogger#blog
. |
|
id
|
string
|
The ID for this resource. | |
name
|
string
|
The name of this blog, which is usually displayed in Blogger as the blog's title. The title can include HTML. | |
description
|
string
|
The description of this blog, which is usually displayed in Blogger underneath the blog's title. The description can include HTML. | |
published
|
datetime
|
RFC 3339
date-time
when this blog was published, for example "2007-02-09T10:13:10-08:00". |
|
updated
|
datetime
|
RFC 3339
date-time
when this blog was last updated, for example "2012-04-15T19:38:01-07:00". |
|
url
|
string
|
The URL where this blog is published. | |
selfLink
|
string
|
The Blogger API URL to fetch this resource from. | |
posts
|
object
|
The container for this blog's posts. | |
posts.
totalItems
|
integer
|
The total number of posts on this blog. | |
posts.
selfLink
|
string
|
The URL of the collection of posts for this blog. | |
pages
|
object
|
The container for this blog's pages. | |
pages.
totalItems
|
integer
|
The total number of pages for this blog. | |
pages.
selfLink
|
string
|
The URL of the pages collection for this blog. | |
locale
|
object
|
The locale this blog is set to, as broken out below. | |
locale.
language
|
string
|
The language this blog is set to, for example "en" for English. | |
locale.
country
|
string
|
The country variant of the language, for example "US" for American English. | |
locale.
variant
|
string
|
The language variant this blog is set to. | |
customMetaData
|
string
|
The JSON custom metadata for the blog | |
posts.
items[]
|
list
|
The list of posts for this Blog. |
Methods
To retrieve a list of blogs that a given user has access rights to, use the blogger.blogs.list method. To retrieve an individual blogs resource, use the blogger.blogs.get method.
- get
- Retrieves a blog by its ID.
- getByUrl
- Retrieves a blog by URL.
- listByUser
- Retrieves a list of blogs.
