Posts
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une ressource "posts" contient le contenu HTML d'un article de blog, ainsi que ses métadonnées.
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#post",
"id": string,
"blog": {
"id": string
},
"published": datetime,
"updated": datetime,
"url": string,
"selfLink": string,
"title": string,
"titleLink": string,
"content": string,
"images": [
{
"url": string
}
],
"author": {
"id": string,
"displayName": string,
"url": string,
"image": {
"url": string
}
},
"replies": {
"totalItems": long,
"selfLink": string,
"items": [
comments Resource
]
},
"labels": [
string
],
"location": {
"name": string,
"lat": double,
"lng": double,
"span": string
},
"status": string
}
Nom de propriété |
Valeur |
Description |
Remarques |
kind |
string |
Genre de cette entité. Toujours blogger#post . |
|
id |
string |
ID de ce post. |
|
blog |
object |
Données sur le blog contenant ce post. |
|
blog.id |
string |
ID du blog contenant ce post. |
|
published |
datetime |
RFC 3339 date-time au moment de la publication de cet article. |
|
updated |
datetime |
RFC 3339 date-time au moment de la dernière mise à jour de cet article. |
|
url |
string |
URL du post. |
|
selfLink |
string |
URL de l'API Blogger à partir de laquelle extraire cette ressource. |
|
title |
string |
Titre du post. |
|
content |
string |
Contenu du post. Peut contenir du balisage HTML. |
|
author |
object |
Auteur de ce post. |
|
author.id |
string |
ID du créateur du post. |
|
author.displayName |
string |
Nom à afficher du créateur du post. |
|
author.url |
string |
URL de la page de profil du créateur du post. |
|
author.image |
object |
Avatar du créateur du post. |
|
author.image.url |
string |
URL de l'avatar du créateur du post. |
|
replies |
object |
Conteneur des commentaires de ce post. |
|
replies.totalItems |
long |
Nombre total de commentaires sur cet article. |
|
replies.selfLink |
string |
URL de l'API Blogger permettant de récupérer les commentaires de cet article. |
|
labels[] |
list |
Liste des libellés associés à cet article. |
|
replies.items[] |
list |
Liste des commentaires de cet article. |
|
location |
object |
Emplacement, si ce post est géotagué. |
|
location.name |
string |
Nom de l'établissement. |
|
location.lat |
double |
Latitude de l'établissement. |
|
location.lng |
double |
Longitude du lieu. |
|
location.span |
string |
Portée de la fenêtre d'affichage de l'établissement. Peut être utilisé lors de l'affichage d'un aperçu de carte. |
|
titleLink |
string |
URL du lien du titre, semblable au lien associé de l'atome. |
|
images[] |
list |
Afficher l'image du post. |
|
images[].url |
string |
|
|
status |
string |
État du post. Défini uniquement pour les requêtes au niveau de l'administrateur |
|
Méthodes
Vous pouvez récupérer la liste des posts d'un blog à l'aide de la méthode list et un post individuel à l'aide de la méthode get.
- liste
- Récupère une liste de posts.
- get
- Récupère un article par ID.
- search
- Recherche un post correspondant aux termes de requête donnés.
- insérer
- Ajout d'un post.
- supprimer
- Supprime un post par ID.
- getByPath
- Récupère un post par chemin d'accès.
- patch
- Met à jour un post. Cette méthode est compatible avec la sémantique de correctif.
- update
- Met à jour un post.
- publier
- Publiez un brouillon d'article.
- annuler
- Rétablir un post publié ou planifié à l'état de brouillon, ce qui le supprime du contenu visible par tous les utilisateurs.
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 2025/05/15 (UTC).
[null,null,["Dernière mise à jour le 2025/05/15 (UTC)."],[[["\u003cp\u003eA posts resource stores a blog post's HTML content and metadata, such as title, author, and publication date.\u003c/p\u003e\n"],["\u003cp\u003eThe resource representation includes details like post ID, blog ID, content, author information, comments, labels, and location.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage posts using various methods: list to retrieve multiple posts, get to retrieve a specific post by ID, and others for searching, inserting, deleting, updating, and publishing.\u003c/p\u003e\n"],["\u003cp\u003ePosts can include custom metadata and images, along with details about the post's location if it is geotagged.\u003c/p\u003e\n"]]],[],null,["# Posts\n\nA posts resource contain the HTML content of a blog post, along with post metadata.\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```objective-c\n{\n \"kind\": \"blogger#post\",\n \"id\": string,\n \"blog\": {\n \"id\": string\n },\n \"published\": datetime,\n \"updated\": datetime,\n \"url\": string,\n \"selfLink\": string,\n \"title\": string,\n \"titleLink\": string,\n \"content\": string,\n \"images\": [\n {\n \"url\": string\n }\n ],\n \"author\": {\n \"id\": string,\n \"displayName\": string,\n \"url\": string,\n \"image\": {\n \"url\": string\n }\n },\n \"replies\": {\n \"totalItems\": long,\n \"selfLink\": string,\n \"items\": [\n comments Resource\n ]\n },\n \"labels\": [\n string\n ],\n \"location\": {\n \"name\": string,\n \"lat\": double,\n \"lng\": double,\n \"span\": string\n },\n \"status\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------------|------------|----------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#post`. | |\n| `id` | `string` | The ID of this post. | |\n| `blog` | `object` | Data about the blog containing this post. | |\n| blog.`id` | `string` | The ID of the blog that contains this post. | |\n| `published` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was published. | |\n| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was last updated. | |\n| `url` | `string` | The URL where this post is displayed. | |\n| `selfLink` | `string` | The Blogger API URL to fetch this resource from. | |\n| `title` | `string` | The title of the post. | |\n| `content` | `string` | The content of the post. Can contain HTML markup. | |\n| `author` | `object` | The author of this post. | |\n| author.`id` | `string` | The ID of the post creator. | |\n| author.`displayName` | `string` | The post creator's display name. | |\n| author.`url` | `string` | The URL of the post creator's profile page. | |\n| author.`image` | `object` | The post creator's avatar. | |\n| author.image.`url` | `string` | The post creator's avatar URL. | |\n| `replies` | `object` | The container for this post's comments. | |\n| replies.`totalItems` | `long` | The total number of comments on this post. | |\n| replies.`selfLink` | `string` | The Blogger API URL of to retrieve the comments for this post. | |\n| `labels[]` | `list` | The list of labels this post was tagged with. | |\n| replies.`items[]` | `list` | The list of comments for this post. | |\n| `location` | `object` | The location, if this post is geotagged. | |\n| location.`name` | `string` | Location name. | |\n| location.`lat` | `double` | Location's latitude. | |\n| location.`lng` | `double` | Location's longitude. | |\n| location.`span` | `string` | Location's viewport span. Can be used when rendering a map preview. | |\n| `titleLink` | `string` | The title link URL, similar to atom's related link. | |\n| `images[]` | `list` | Display image for the Post. | |\n| images[].`url` | `string` | | |\n| `status` | `string` | Status of the post. Only set for admin-level requests | |\n\nMethods\n-------\n\nYou can retrieve the list of posts for a blog using the [list](/blogger/docs/3.0/reference/posts/list) method, and retrieve an individual post using the [get](/blogger/docs/3.0/reference/posts/get) method.\n\n[list](/blogger/docs/3.0/reference/posts/list)\n: Retrieves a list of posts.\n\n[get](/blogger/docs/3.0/reference/posts/get)\n: Retrieves one post by post ID.\n\n[search](/blogger/docs/3.0/reference/posts/search)\n: Searches for a post that matches the given query terms.\n\n[insert](/blogger/docs/3.0/reference/posts/insert)\n: Adds a post.\n\n[delete](/blogger/docs/3.0/reference/posts/delete)\n: Deletes a post by ID.\n\n[getByPath](/blogger/docs/3.0/reference/posts/getByPath)\n: Retrieves a post by path.\n\n[patch](/blogger/docs/3.0/reference/posts/patch)\n: Updates a post. This method supports [patch semantics](/blogger/docs/3.0/performance).\n\n[update](/blogger/docs/3.0/reference/posts/update)\n: Updates a post.\n\n[publish](/blogger/docs/3.0/reference/posts/publish)\n: Publish a draft post.\n\n[revert](/blogger/docs/3.0/reference/posts/revert)\n: Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content."]]