دليل مرجعي

ملاحظة مهمة: هذه نسخة قديمة من هذه الصفحة. للحصول على أحدث إصدار، استخدِم الروابط في شريط القوائم العلوي على يمين الصفحة.

يوفّر هذا المستند مستندات مرجعية مفصّلة للبروتوكول الأوّلي (XML وHTTP) لواجهة برمجة التطبيقات Blogger Data API.

لا يحتوي هذا المستند على معلومات حول لغة البرمجة مكتبات العملاء. للحصول على معلومات مرجعية في مكتبة العميل، راجع الروابط من الأقسام الخاصة بلغة البرمجة في دليل المطوّر.

المحتويات

الجمهور

هذا المستند مخصّص للمبرمجين الذين يريدون كتابة تطبيقات عملاء يمكنها التفاعل مع Blogger.

إنها وثيقة مرجعية؛ يفترض أنك تفهم المفاهيم الواردة في دليل المطوِّر للأفكار العامة التي تستند إليها واجهات برمجة التطبيقات لبيانات Google والبروتوكول.

أنواع خلاصات Blogger

توفر خدمة Blogger تمثيلين لمحتوى المدونة في الخلاصات: الخلاصات الكاملة خلاصات الملخص. تحتوي الخلاصة الكاملة على مشاركات مدوّنة كاملة، بينما تحتوي الخلاصة التلخيصية على مقتطف قصير فقط من كل مشاركة.

يمكن لمالك المدونة تحديد ما إذا كانت المدونة ستزوده، باستخدام إعدادات واجهة المستخدم الرسومية، خلاصة كاملة أو خلاصة ملخّصة للقرّاء ومجمّعي المحتوى.

عندما يرسل تطبيق العميل طلبًا غير مصادق عليه لخلاصة، يتلقّى أي نوع من الخلاصات حدّده مالك المدوّنة.

ومع ذلك، عندما يرسل تطبيقك العميل طلبًا تمت مصادقته، يتم دائمًا خلاصة كاملة، بغض النظر عما يحدده مالك المدونة.

مرجع مَعلمات طلب البحث في Blogger

تدعم واجهة برمجة تطبيقات Blogger Data API تقريبًا جميع مَعلمات طلب البحث في Data API

لا يتيح Blogger المَعلمتَين q (البحث النصي) و author.

مَعلمتا طلب البحث updated-min وupdated-max ما لم يتم ضبط المعلَمة orderby على updated على سبيل المثال، يسترجع عنوان URL التالي كل مشاركات المدونة التي تم تعديلها من 16 آذار (مارس) 2008 إلى 24 آذار (مارس) 2008:

http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated

مرجع عناصر Blogger

لا تستخدم Blogger Data API سوى عناصر Atom العادية. لمزيد من المعلومات، اطّلِع على مواصفات تنسيق مشاركة البيانات بتنسيق Atom 1.0 وبروتوكول نشر Atom.

تقدّم بقية هذا القسم ملاحظتَين محدّدتَين حول استخدام Blogger لبعض العناصر العادية.

مسودّات الإدخالات

يتم وضع علامة على مسودة إدخال مدونة باستخدام عنصر الإضافة <app:draft> المحدّد في مستند Atom Publishing Protocol. إليك مثال على مسودة إدخال:

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

إذا لم يتم تحديد عنصر <draft>، لن يكون الإدخال مسودة.

تواريخ النشر والتواريخ المعدّلة

يتوافق الطابع الزمني الوارد في عنصر <published> Atom العادي مع "تاريخ النشر" الذي يمكن للمستخدم ضبطه في واجهة مستخدم Blogger.

عندما ينشئ العميل إدخالًا جديدًا، إذا لم يحدّد العميل قيمة للعنصر <published>، سيضبط Blogger تاريخ نشر الإدخال على وقت الخادم الحالي. عندما يعدّل العميل إدخالًا بدون تحديد قيمة <published>، يترك Blogger تاريخ نشر الإدخال بدون تغيير.

ومع ذلك، إذا حدّد العميل قيمة للعنصر <published> عند إنشاء إدخال أو تعديله، سيضبط Blogger تاريخ نشر الإدخال على القيمة المحدّدة. يمكن أن يكون هذا مفيدًا لمهام مثل استيراد الإدخالات القديمة من نظام تدوين آخر (مع الاحتفاظ تواريخ الإنشاء الأصلية).

يستخدم Blogger عنصر Atom <updated> العادي من أجل للإشارة إلى آخر وقت تم فيه تغيير الإدخال. لا يمكن لعميلك التحكّم في قيمة <updated>، إذ يضبط Blogger دائمًا تاريخ تعديل المشاركة على وقت الخادم الحالي كلما نشر العميل مشاركًا أو عدّلها.

يمكنك استخدام الإصدار العادي من Google Data API published-min published-max وupdated-min و updated-max مَعلمات طلب بحث لطلب إدخالات استنادًا إلى القيمتان <published> أو <updated> ومع ذلك، للاطّلاع على ملاحظات حول طلب البحث حسب التواريخ المعدَّلة، يمكنك الاطّلاع على مرجع مَعلمات طلب البحث في Blogger .

ربط التعليقات بالمشاركات

تصدير Blogger يحتوي التنسيق على كل من المشاركات والتعليقات في مستند واحد لخلاصة Atom. لتمييّز نوعَي الإدخالات، يستخدم Blogger عنصر <atom:category>. سيكون لهذا العنصر معلَمة term التي توضح ما إذا كان الإدخال متعلقًا بمشاركة أو التعليق

علاوة على ذلك، فإن ربط إدخال التعليق بإدخال المنشور الذي ينتمي إليه من خلال استخدام إضافة Atom Threading. في جلسة المعمل، المثال أدناه، العنصر <thr:in-reply-to> في التعليق سيشير إلى المشاركة باستخدام معرّف إدخال المشاركة في مَعلمة ref. كما يرتبط أيضًا بعنوان URL الخاص بالمشاركة على HTML من خلال مَعلمة href.

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

الرجوع إلى الأعلى