網誌:get
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
透過 ID 擷取網誌。
立即試用或查看範例。
如果網誌設為私人,則需要授權。如果是公開網誌,就可以在未經授權的情況下呼叫這個方法。
要求
HTTP 要求
GET https://www.googleapis.com/blogger/v3/blogs/blogId
參數
參數名稱 |
值 |
說明 |
必要參數 |
blogId |
string |
要取得的網誌 ID。
|
選用參數 |
maxPosts |
unsigned integer |
與網誌一併擷取的文章數量上限。如未指定這個參數,系統就不會在網誌資源中傳回任何文章。
|
要求主體
請勿使用這個方法提供請求主體。
回應
如果成功的話,這個方法會在回應內文中傳回網誌資源。
範例
注意:這個方法適用的程式語言眾多,我們只在此提供部分程式碼範例,完整的支援語言清單請參閱用戶端程式庫頁面。
Java
使用 Java 用戶端程式庫
// The BlogId for the http://code.blogger.com/ blog.
String CODE_BLOG_ID = "3213900";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure for 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-BlogGet-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// This is the request action that you can configure before sending the request.
Get blogGetAction = blogger.blogs().get(CODE_BLOG_ID);
// Restrict the result content to just the data we need.
blogGetAction.setFields("description,name,posts/totalItems,updated");
// This step sends the request to the server.
Blog blog = blogGetAction.execute();
// Now we can navigate the response.
System.out.println("Name: "+blog.getName());
System.out.println("Description: "+blog.getDescription());
System.out.println("Post Count: "+blog.getPosts().getTotalItems());
System.out.println("Last Updated: "+blog.getUpdated());
試試看!
使用下方的 APIs Explorer,針對即時資料呼叫這個方法,看看會有什麼結果。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-09 (世界標準時間)。
[null,null,["上次更新時間:2024-08-09 (世界標準時間)。"],[[["\u003cp\u003eRetrieves a specific blog using its unique ID.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization for private blogs but not for public ones.\u003c/p\u003e\n"],["\u003cp\u003eOptionally retrieves a specified maximum number of posts associated with the blog.\u003c/p\u003e\n"],["\u003cp\u003eReturns a detailed blog resource containing information like description, name, post count, and last updated date upon successful execution.\u003c/p\u003e\n"],["\u003cp\u003eProvides code examples in Java demonstrating how to use the API to retrieve and access blog data.\u003c/p\u003e\n"]]],[],null,["# Blogs: get\n\nRetrieves a blog by its ID.\n[Try it now](#try-it) or [see an example](#examples).\n\n[Authorization](/blogger/docs/3.0/using#auth) is required if the blog is private. If the blog is public, then this method can be called without authorization.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/blogs/blogId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | The ID of the blog to get. |\n| **Optional parameters** |||\n| `maxPosts` | `unsigned integer` | Maximum number of posts to retrieve along with the blog. When this parameter is not specified, no posts will be returned as part of the blog resource. |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Blogs resource](/blogger/docs/3.0/reference/blogs#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 for the http://code.blogger.com/ blog.\nString CODE_BLOG_ID = \"3213900\";\n\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure for 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-BlogGet-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// This is the request action that you can configure before sending the request.\nGet blogGetAction = blogger.blogs().get(CODE_BLOG_ID);\n\n// Restrict the result content to just the data we need.\n\nblogGetAction.setFields(\"description,name,posts/totalItems,updated\");\n\n// This step sends the request to the server.\nBlog blog = blogGetAction.execute();\n\n// Now we can navigate the response.\nSystem.out.println(\"Name: \"+blog.getName());\nSystem.out.println(\"Description: \"+blog.getDescription());\nSystem.out.println(\"Post Count: \"+blog.getPosts().getTotalItems());\nSystem.out.println(\"Last Updated: \"+blog.getUpdated());\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]