בלוגים: קבל
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אחזור בלוג לפי המזהה שלו.
אפשר לנסות עכשיו או לראות דוגמה.
אם הבלוג פרטי, נדרשת הרשאה. אם הבלוג גלוי לכולם, אפשר לקרוא לשיטה הזו ללא הרשאה.
בקשה
בקשת HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId
פרמטרים
שם הפרמטר |
ערך |
תיאור |
פרמטרים נדרשים |
blogId |
string |
מזהה הבלוג שצריך לקבל.
|
פרמטרים אופציונליים |
maxPosts |
unsigned integer |
מספר הפוסטים המקסימלי שאפשר לאחזר יחד עם הבלוג. אם לא תציינו את הפרמטר הזה, לא יוחזרו רשומות כחלק ממשאב הבלוג.
|
גוף הבקשה
אל תספקו גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Blogs בגוף התשובה.
דוגמאות
הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).
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 שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-09 (שעון UTC).
[null,null,["עדכון אחרון: 2024-08-09 (שעון UTC)."],[[["\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."]]