المدوّنات

المدونة هي فئة البيانات الجذر في واجهة برمجة تطبيقات Blogger. تحتوي كل مدونة على سلسلة من المشاركات والصفحات، وتتضمّن كل مشاركة سلسلة من التعليقات. 

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

{
  "kind": "blogger#blog",
  "id": value,
  "name": value,
  "description": value,
  "published": value,
  "updated": value,
  "url": value,
  "selfLink": value,
  "posts": {
    "totalItems": value,
    "selfLink": value
  },
  "pages": {
    "totalItems": value,
    "selfLink": value
  },
  "locale": {
    "language": value,
    "country": value,
    "variant": value
  }
}
اسم الموقع القيمة الوصف Notes
kind string نوع هذا الإدخال. دائمًا blogger#blog.
id string تمثّل هذه السمة رقم تعريف هذا المرجع.
name string اسم هذه المدونة، والذي يتم عرضه عادةً في Blogger كعنوان المدونة. يمكن أن يتضمن العنوان HTML.
description string وصف هذه المدونة، والذي يتم عرضه عادةً في Blogger أسفل عنوان المدونة. يمكن أن يتضمن الوصف HTML.
published datetime RFC 3339 date-time عند نشر هذه المدونة، على سبيل المثال "2007-02-09T10:13:10-08:00".
updated datetime RFC 3339 date-time عند آخر تعديل لهذه المدونة، على سبيل المثال "2012-04-15T19:38:01-07:00".
url string تمثّل هذه السمة عنوان URL الذي يتم نشر هذه المدونة فيه.
posts object حاوية مشاركات هذه المدونة
posts.totalItems integer إجمالي عدد المشاركات في هذه المدونة.
pages object حاوية صفحات هذه المدونة.
pages.totalItems integer إجمالي عدد صفحات هذه المدونة.
locale object اللغة التي تم تعيين هذه المدونة عليها، كما هو موضح أدناه.
locale.language string اللغة التي تم ضبط هذه المدونة عليها، على سبيل المثال "en" للّغة الإنجليزية.
locale.country string تمثّل هذه السمة صيغة البلد الخاصة باللغة، مثل "مصر" للّغة الإنجليزية الأمريكية.
locale.variant string صيغة اللغة التي تم ضبط هذه المدونة عليها.
customMetaData string البيانات الوصفية المخصّصة بتنسيق JSON للمدونة
posts.items[] list قائمة مشاركات هذه المدونة

الطُرق

لاسترداد قائمة بالمدونات التي يمتلك مستخدم معين حقوق الوصول إليها، استخدِم طريقة blogger.blogs.list. لاسترداد مورد blogs فردي، استخدِم طريقة blogger.blogs.get.

الحصول على
استرداد مدونة باستخدام رقم التعريف الخاص بها
getByUrl
استرداد مدونة باستخدام عنوان URL
listByUser
استرداد قائمة بالمدونات.