Blogs
Stay organized with collections
Save and categorize content based on your preferences.
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. |
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-06-26 UTC."],[[["\u003cp\u003eA blog in the Blogger API is the primary data structure, containing posts, pages, and associated comments.\u003c/p\u003e\n"],["\u003cp\u003eEach blog has metadata such as title, description, publication date, update date, and locale information.\u003c/p\u003e\n"],["\u003cp\u003eBlogs can be accessed and managed through dedicated API methods like \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003egetByUrl\u003c/code\u003e, and \u003ccode\u003elistByUser\u003c/code\u003e, enabling developers to retrieve individual blogs or lists of blogs associated with a specific user.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides comprehensive access to blog data, including the number of posts and pages, as well as links to access these collections.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the \u003ccode\u003eposts\u003c/code\u003e and \u003ccode\u003epages\u003c/code\u003e properties to retrieve and interact with a blog's content.\u003c/p\u003e\n"]]],[],null,["# Blogs\n\nA blog is the root data class for the Blogger API. Each blog has a series of [posts](/blogger/docs/3.0/reference/posts) and [pages](/blogger/docs/3.0/reference/pages), and each post has a series of [comments](/blogger/docs/3.0/reference/comments).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```gdscript\n{\n \"kind\": \"blogger#blog\",\n \"id\": value,\n \"name\": value,\n \"description\": value,\n \"published\": value,\n \"updated\": value,\n \"url\": value,\n \"selfLink\": value,\n \"posts\": {\n \"totalItems\": value,\n \"selfLink\": value\n },\n \"pages\": {\n \"totalItems\": value,\n \"selfLink\": value\n },\n \"locale\": {\n \"language\": value,\n \"country\": value,\n \"variant\": value\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|--------------------|------------|---------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entry. Always `blogger#blog`. | |\n| `id` | `string` | The ID for this resource. | |\n| `name` | `string` | The name of this blog, which is usually displayed in Blogger as the blog's title. The title can include HTML. | |\n| `description` | `string` | The description of this blog, which is usually displayed in Blogger underneath the blog's title. The description can include HTML. | |\n| `published` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this blog was published, for example \"2007-02-09T10:13:10-08:00\". | |\n| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this blog was last updated, for example \"2012-04-15T19:38:01-07:00\". | |\n| `url` | `string` | The URL where this blog is published. | |\n| `selfLink` | `string` | The Blogger API URL to fetch this resource from. | |\n| `posts` | `object` | The container for this blog's posts. | |\n| posts.`totalItems` | `integer` | The total number of posts on this blog. | |\n| posts.`selfLink` | `string` | The URL of the collection of posts for this blog. | |\n| `pages` | `object` | The container for this blog's pages. | |\n| pages.`totalItems` | `integer` | The total number of pages for this blog. | |\n| pages.`selfLink` | `string` | The URL of the pages collection for this blog. | |\n| `locale` | `object` | The locale this blog is set to, as broken out below. | |\n| locale.`language` | `string` | The language this blog is set to, for example \"en\" for English. | |\n| locale.`country` | `string` | The country variant of the language, for example \"US\" for American English. | |\n| locale.`variant` | `string` | The language variant this blog is set to. | |\n| `customMetaData` | `string` | The JSON custom metadata for the blog | |\n| posts.`items[]` | `list` | The list of posts for this Blog. | |\n\nMethods\n-------\n\nTo retrieve a list of blogs that a given [user](/blogger/docs/3.0/reference/users#resource) has access rights to, use the [blogger.blogs.list](/blogger/docs/3.0/reference/blogs/list) method. To retrieve an individual [blogs](/blogger/docs/3.0/reference/blogs#resource) resource, use the [blogger.blogs.get](/blogger/docs/3.0/reference/blogs/get) method.\n\n[get](/blogger/docs/3.0/reference/blogs/get)\n: Retrieves a blog by its ID.\n\n[getByUrl](/blogger/docs/3.0/reference/blogs/getByUrl)\n: Retrieves a blog by URL.\n\n[listByUser](/blogger/docs/3.0/reference/blogs/listByUser)\n: Retrieves a list of blogs."]]