Posts: insérer
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Autorisation requise
Ajoute un post.
Essayez dès maintenant ou consultez un exemple.
Requête
Requête HTTP
POST https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Paramètres
Nom du paramètre |
Valeur |
Description |
Paramètres obligatoires |
blogId |
string |
ID du blog auquel l'article doit être ajouté.
|
Paramètres facultatifs |
isDraft |
boolean |
Créer ou non le post en tant que brouillon
|
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
Champ d'application |
https://www.googleapis.com/auth/blogger |
Corps de la requête
Dans le corps de la requête, indiquez une ressource "Posts".
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource "Posts" dans le corps de la réponse.
Exemples
Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).
Java
Elle utilise la bibliothèque cliente Java.
// The BlogId of a test blog.
String TEST_BLOG_ID = "8070105920543249955";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-PostsInsert-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// Construct a post to insert
Post content = new Post();
content.setTitle("A test post");
content.setContent("With <code>HTML</code> content");
// The request action.
Insert postsInsertAction = blogger.posts()
.insert(TEST_BLOG_ID, content);
// Restrict the result content to just the data we need.
postsInsertAction.setFields("author/displayName,content,published,title,url");
// This step sends the request to the server.
Post post = postsInsertAction.execute();
// Now we can navigate the response.
System.out.println("Title: " + post.getTitle());
System.out.println("Author: " + post.getAuthor().getDisplayName());
System.out.println("Published: " + post.getPublished());
System.out.println("URL: " + post.getUrl());
System.out.println("Content: " + post.getContent());
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
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/08/09 (UTC).
[null,null,["Dernière mise à jour le 2024/08/09 (UTC)."],[[["\u003cp\u003eAdds a new post to a specified blog using the \u003ccode\u003ePOST\u003c/code\u003e method and requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/blogger\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003ePosts resource\u003c/code\u003e specifying the post details, including title and content.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution returns a \u003ccode\u003ePosts resource\u003c/code\u003e with details of the created post such as title, author, publication date, URL, and content.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use various client libraries, like the Java client library shown in the example, to interact with the API.\u003c/p\u003e\n"],["\u003cp\u003eAn interactive API Explorer is available for users to test the method with live data and examine the responses directly.\u003c/p\u003e\n"]]],[],null,["# Posts: insert\n\n**Requires [authorization](#auth)**\n\nAdds a post.\n[Try it now](#try-it) or [see an example](#examples).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/blogger/v3/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|---------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to add the post to. |\n| **Optional parameters** |||\n| `isDraft` | `boolean` | Whether to create the post as a draft |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|-------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n\n### Request body\n\nIn the request body, supply a [Posts resource](/blogger/docs/3.0/reference/posts#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [Posts resource](/blogger/docs/3.0/reference/posts#resource) in the response body.\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/blogger/docs/3.0/libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](http://code.google.com/p/google-api-java-client/) \n\n```java\n// The BlogId of a test blog.\nString TEST_BLOG_ID = \"8070105920543249955\";\n\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure the Installed App OAuth2 flow.\nCredential credential = OAuth2Native.authorize(HTTP_TRANSPORT,\n\tJSON_FACTORY, new LocalServerReceiver(),\n\tArrays.asList(BloggerScopes.BLOGGER));\n\n// Construct the Blogger API access facade object.\nBlogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)\n\t.setApplicationName(\"Blogger-PostsInsert-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// Construct a post to insert\nPost content = new Post();\ncontent.setTitle(\"A test post\");\ncontent.setContent(\"With \u003ccode\u003eHTML\u003c/code\u003e content\");\n\n// The request action.\nInsert postsInsertAction = blogger.posts()\n\t.insert(TEST_BLOG_ID, content);\n\n// Restrict the result content to just the data we need.\npostsInsertAction.setFields(\"author/displayName,content,published,title,url\");\n\n// This step sends the request to the server.\nPost post = postsInsertAction.execute();\n\n// Now we can navigate the response.\nSystem.out.println(\"Title: \" + post.getTitle());\nSystem.out.println(\"Author: \" + post.getAuthor().getDisplayName());\nSystem.out.println(\"Published: \" + post.getPublished());\nSystem.out.println(\"URL: \" + post.getUrl());\nSystem.out.println(\"Content: \" + post.getContent());\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]