المشاركات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحتوي مرجع المشاركات على محتوى HTML لمقالة مدونة، بالإضافة إلى البيانات الوصفية للمقالة.
للحصول على قائمة بالأساليب لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.
تمثيلات الموارد
{
"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
}
اسم السمة |
القيمة |
الوصف |
ملاحظات |
kind |
string |
نوع هذا الكيان. blogger#post دائمًا |
|
id |
string |
معرّف هذه المشاركة. |
|
blog |
object |
بيانات عن المدوّنة التي تتضمّن هذه المشاركة |
|
blog.id |
string |
معرّف المدوّنة التي تتضمّن هذا المنشور |
|
published |
datetime |
RFC 3339 date-time عند نشر هذه المشاركة |
|
updated |
datetime |
RFC 3339 date-time عند آخر تعديل على هذا المنشور |
|
url |
string |
عنوان URL الذي يتم عرض هذه المشاركة عليه |
|
selfLink |
string |
عنوان URL لواجهة برمجة تطبيقات Blogger التي يتم جلب هذا المرجع منها. |
|
title |
string |
تمثّل هذه السمة عنوان المشاركة. |
|
content |
string |
محتوى المشاركة يمكن أن يحتوي على ترميز HTML. |
|
author |
object |
مؤلف هذه المشاركة. |
|
author.id |
string |
معرّف منشئ المشاركة |
|
author.displayName |
string |
الاسم المعروض لصانع المشاركة. |
|
author.url |
string |
عنوان URL لصفحة الملف الشخصي لصانع المشاركة. |
|
author.image |
object |
الصورة الرمزية لصانع المشاركة |
|
author.image.url |
string |
عنوان URL الخاص بأفاتار صانع المشاركة |
|
replies |
object |
حاوية تعليقات هذه المشاركة |
|
replies.totalItems |
long |
إجمالي عدد التعليقات على هذه المشاركة. |
|
replies.selfLink |
string |
عنوان URL لواجهة برمجة التطبيقات Blogger لاسترداد تعليقات هذه المشاركة. |
|
labels[] |
list |
قائمة التصنيفات التي تمّت الإشارة إليها في هذه المشاركة |
|
replies.items[] |
list |
قائمة التعليقات على هذه المشاركة |
|
location |
object |
الموقع الجغرافي، إذا كانت هذه المشاركة تتضمّن علامة جغرافية |
|
location.name |
string |
اسم الموقع الجغرافي |
|
location.lat |
double |
خط العرض للموقع الجغرافي |
|
location.lng |
double |
خط طول الموقع الجغرافي |
|
location.span |
string |
نطاق إطار عرض الموقع الجغرافي يمكن استخدامها عند عرض معاينة الخريطة. |
|
titleLink |
string |
عنوان URL الخاص برابط العنوان، وهو مشابه لرابط atom ذي الصلة. |
|
images[] |
list |
عرض صورة للمشاركة |
|
images[].url |
string |
|
|
status |
string |
حالة المشاركة يتم ضبطها للطلبات على مستوى المشرف فقط. |
|
الطُرق
يمكنك استرداد قائمة المشاركات في مدوّنة باستخدام الطريقة list، واسترداد مشاركة فردية باستخدام الطريقة get.
- list
- استرداد قائمة بالمشاركات
- الحصول
- استرداد مشاركة واحدة حسب معرّف المشاركة
- search
- يبحث عن مشاركة تتطابق مع عبارات طلب البحث المحدّدة.
- إدراج
- إضافة مشاركة
- حذف
- لحذف مشاركة حسب رقم التعريف
- getByPath
- استرداد مشاركة حسب المسار
- patch
- تعديل مشاركة تتيح هذه الطريقة دلالات التعديل.
- تعديل
- تعديل مشاركة
- نشر
- انشر مسودة مشاركة.
- التراجع
- يمكنك إعادة مشاركة منشورة أو مجدوَلة إلى حالة مسودة، ما يؤدي إلى إزالة المشاركة من المحتوى المتاح للجميع.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-05-15 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-05-15 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]