Blogs (original) (raw)

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
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.