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
}
}
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."]]
