Blogs
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Un blog est la classe de données racine de l'API Blogger. Chaque blog contient une série d'articles et de pages, et chaque article contient une série de commentaires.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
{
"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
}
}
Nom de propriété |
Valeur |
Description |
Remarques |
kind |
string |
Type d'entrée. Toujours blogger#blog . |
|
id |
string |
ID de cette ressource. |
|
name |
string |
Nom du blog, généralement affiché dans Blogger comme titre. Le titre peut inclure du code HTML. |
|
description |
string |
Description du blog, généralement affichée dans Blogger sous le titre du blog. La description peut inclure du code HTML. |
|
published |
datetime |
RFC 3339 date-time lors de la publication de ce blog, par exemple "2007-02-09T10:13:10-08:00". |
|
updated |
datetime |
RFC 3339 date-time lors de la dernière mise à jour de ce blog, par exemple "2012-04-15T19:38:01-07:00". |
|
url |
string |
URL de la page sur laquelle ce blog est publié. |
|
selfLink |
string |
URL de l'API Blogger à partir de laquelle extraire cette ressource. |
|
posts |
object |
Conteneur des articles de ce blog. |
|
posts.totalItems |
integer |
Nombre total d'articles sur ce blog. |
|
posts.selfLink |
string |
URL de la collection des articles de ce blog. |
|
pages |
object |
Conteneur des pages de ce blog. |
|
pages.totalItems |
integer |
Nombre total de pages de ce blog. |
|
pages.selfLink |
string |
URL de la collection de pages pour ce blog. |
|
locale |
object |
Paramètres régionaux définis pour ce blog, comme expliqué ci-dessous. |
|
locale.language |
string |
Langue définie pour ce blog, par exemple "fr" pour l'anglais. |
|
locale.country |
string |
Variante pays de la langue, par exemple "US" pour l'anglais américain. |
|
locale.variant |
string |
Variante de langue utilisée pour ce blog. |
|
customMetaData |
string |
Métadonnées JSON personnalisées pour le blog |
|
posts.items[] |
list |
Liste des articles de ce blog. |
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/06/26 (UTC).
[null,null,["Dernière mise à jour le 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."]]