المدوّنات

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

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

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

{
  "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
  }
}

اسم السمة	القيمة	الوصف	ملاحظات
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 الذي يتم نشر هذه المدونة عليه.
selfLink	string	عنوان URL الخاص بواجهة Blogger API الذي سيتم استرداد هذا المرجع منه.
posts	object	تمثّل هذه السمة الحاوية التي تتضمّن مشاركات هذه المدونة.
posts.totalItems	integer	تمثّل هذه السمة إجمالي عدد المشاركات في هذه المدونة.
posts.selfLink	string	تمثّل هذه السمة عنوان URL لمجموعة المشاركات في هذه المدونة.
pages	object	حاوية صفحات هذه المدونة
pages.totalItems	integer	إجمالي عدد الصفحات في هذه المدونة
pages.selfLink	string	تمثّل هذه السمة عنوان URL لمجموعة الصفحات الخاصة بهذه المدونة.
locale	object	اللغة التي تم ضبط هذه المدونة عليها، كما هو موضّح أدناه
locale.language	string	اللغة التي تم ضبط هذه المدونة عليها، مثلاً "ar" للعربية
locale.country	string	تُستخدَم لتحديد البلد الذي يتم فيه استخدام اللغة، مثلاً "US" للغة الإنجليزية الأمريكية.
locale.variant	string	صيغة اللغة التي تم ضبط هذه المدونة عليها
customMetaData	string	البيانات الوصفية المخصّصة بتنسيق JSON للمدوّنة
posts.items[]	list	قائمة المشاركات في هذه المدونة

الطُرق

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

الحصول على

استرداد مدونة حسب رقم تعريفها

getByUrl

تعرض هذه الطريقة مدونة حسب عنوان URL.

listByUser

استرداد قائمة بالمدوّنات