المشاركات: الحصول على
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاسترداد مشاركة واحدة بواسطة رقم تعريف المشاركة.
جرِّب الخدمة الآن أو اطّلِع على مثال.
يجب الحصول على إذن الوصول إذا كانت المشاركة على مدونة خاصة. إذا كانت المشاركة على مدونة عامة، يمكن عندئذٍ استدعاء هذه الطريقة بدون إذن.
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
المَعلمات المطلوبة |
blogId |
string |
رقم تعريف المدونة المطلوب جلب المشاركة منها.
|
postId |
string |
رقم تعريف المشاركة.
|
المَعلمات الاختيارية |
view |
string |
في ما يلي القيم المقبولة:
- "
ADMIN ": تفاصيل على مستوى المشرف
- "
AUTHOR ": تفاصيل على مستوى المؤلف
- "
READER ": تفاصيل على مستوى المشرف
|
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض مورد المشاركات في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
لاستخدام مكتبة برامج Java
// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";
// The PostId for a buzz post with comments.
String BUZZ_POST_ID = "5310628572012276714";
// 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-PostsGet-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
Get postsGetAction = blogger.posts().get(BUZZ_BLOG_ID, BUZZ_POST_ID);
// Restrict the result content to just the data we need.
postsGetAction.setFields("author/displayName,content,published,title,url");
// This step sends the request to the server.
Post post = postsGetAction.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());
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a single blog post using its unique post ID and the blog ID.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization for private blogs but not for public ones.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying the maximum number of comments to retrieve and the level of detail in the response (admin, author, or reader).\u003c/p\u003e\n"],["\u003cp\u003eProvides code examples in Java demonstrating how to use the API to get a post.\u003c/p\u003e\n"]]],[],null,["# Posts: get\n\nRetrieves one post by post 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 post is on a blog that is private. If the post is on a blog that 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/posts/postId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | The ID of the blog to fetch the post from. |\n| `postId` | `string` | The ID of the post. |\n| **Optional parameters** |||\n| `maxComments` | `unsigned integer` | Maximum number of comments to retrieve as part of the the post resource. If this parameter is left unspecified, then no comments will be returned. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Admin level detail |\n\n### Request body\n\nDo not supply a request body with this method.\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 for the http://buzz.blogger.com/ blog.\nString BUZZ_BLOG_ID = \"2399953\";\n\n// The PostId for a buzz post with comments.\nString BUZZ_POST_ID = \"5310628572012276714\";\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-PostsGet-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// The request action.\nGet postsGetAction = blogger.posts().get(BUZZ_BLOG_ID, BUZZ_POST_ID);\n\n// Restrict the result content to just the data we need.\npostsGetAction.setFields(\"author/displayName,content,published,title,url\");\n\n// This step sends the request to the server.\nPost post = postsGetAction.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."]]