ملاحظة مهمة: هذه نسخة قديمة من هذه الصفحة. للحصول على أحدث إصدار، استخدِم الروابط في شريط القوائم العلوي على يمين الصفحة.
يوفّر هذا المستند مستندات مرجعية مفصّلة للبروتوكول الأوّلي (XML وHTTP) لواجهة برمجة التطبيقات Blogger Data API.
لا يحتوي هذا المستند على معلومات عن مكتبات العميل للغة البرمجة. للحصول على معلومات مرجعية عن مكتبة العميل، اطّلِع على الروابط الواردة من الأقسام الخاصة بلغة البرمجة في دليل المطوّر.
المحتويات
الجمهور
هذا المستند مخصّص للمبرمجين الذين يريدون كتابة تطبيقات عملاء يمكنها التفاعل مع Blogger.
هذا المستند مرجعي، ويفترض أنّك تفهم المفاهيم المقدَّمة في دليل المطوّر، وكذلك الافكار العامة التي تستند إليها بروتوكول Google Data APIs.
أنواع خلاصات Blogger
يوفّر Blogger عرضَين لمحتوى المدونة في الخلاصات: الخلاصات الكاملة و الخلاصات التلخيصية. تحتوي الخلاصة الكاملة على مشاركات مدوّنة كاملة، بينما تحتوي الخلاصة التلخيصية على مقتطف قصير فقط من كل مشاركة.
يمكن لمالك المدونة تحديد ما إذا كانت المدونة توفّر خلاصة كاملة أو خلاصة تلخيصية لجهات النشر والخلاصات.
عندما يُرسِل تطبيق العميل طلبًا غير مُعتمَد للحصول على خلاصة، يتلقّى أي نوع من الخلاصات حدّده مالك المدوّنة.
ومع ذلك، عندما يُرسِل تطبيق العميل طلبًا موثَّقًا، يتلقّى دائمًا خلاصة كاملة، بغض النظر عمّا حدّده مالك المدوّنة.
مرجع مَعلمات طلب البحث في Blogger
تتوافق Blogger Data API مع جميع مَعلمات طلب البحث العادية في Google 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 دائمًا تاريخ تعديل
المشاركة على وقت الخادم الحالي كلما نشر العميل مشاركًا أو عدّلها.
يمكنك استخدام مَعلمات طلب البحث العادية published-min و
published-max وupdated-min و
updated-max في Google Data API لطلب الإدخالات استنادًا إلى قيم
<published> أو <updated>. ومع ذلك،
للاطّلاع على ملاحظات حول طلب البحث عن تواريخ معدَّلة، يمكنك الاطّلاع على مرجع مَعلمات طلب البحث في Blogger.
ربط التعليقات بالمشاركات
يحتوي تنسيق
التصدير في Blogger على كلّ من المشاركات وإدخالات التعليقات في مستند خلاصة Atom واحد.
للتمييز بين نوعَي الإدخالات، يستخدم Blogger عنصر
<atom:category>. سيحتوي هذا العنصر على مَعلمة
term تشير إلى ما إذا كان الإدخال خاصًا بمشاركة أو
تعليق.
بالإضافة إلى ذلك، يتم ربط إدخال التعليق بإدخال المشاركة الذي ينتمي إليه
من خلال استخدام إضافة سلاسل المحادثات في Atom. في المثال أدناه، سيشير العنصر <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>