بلوجر آبي Blogger API: ابدأ

يشرح هذا المستند كيفية البدء في استخدام واجهة برمجة تطبيقات بلوجر.

لا نتكلم هنا عن كيفية إنشاء مدونة بلوجر بل عن كيفية تطوير تطبيق بلوجر، أي التطبيق الذي من خلاله يتمكن الاشخاص من إنشاء مدونة بلوجر.

       قبل البدأ

   قبل البدأ يجب التوفر على حساب غوغل أي التوفر على بريد إليكتروني غوغل يتيح لك التمتع بحساب غوغل.

   تأكد من توفرك على حساب غوغل، و الافضل تخصيص حساب لتطوير، لتفادي فقدان محتوى مدونتك عند إجراء اختبارات عليها، إذا كان لديك فعلا هذا الحساب التجريبي فأنت الآن على استعداد للبدأ:

   قبل بداية البرمجة يجب ان تكون واجهة المستخدم بلوجر مألوفة لديك واجهة المستخذم user interface.

• طلبات الترخيص authorizing و معرف identifying التطبيق الخاص بك.

   عندما يستدعي تطبيقك معلومات خاصة يكون في حاجة إلى ترخيص أو مصادقة مستخدم له الحق في الوصول إلى تلك البيانات، أمَّا في حالة استدعاء بيانات عامة فلن تكون في حاجة إلى مصادقة او ترخيص لإستخذامها، لكن تحتاج إلى معرف لتلك البيانات مثل مفتاح آبي API key لإستدعائها.

   للحصول على معلومات حول كيفية تفويض الطلبات واستخدام مفاتيح API، طالع  Authorizing requests and identifying your application في وثائق استخذام آبي.

   بلوجر API للخلفية أو الواجهة Blogger API background: 

مفاهيم المدون:

تم تصميم بلوجر على خمسة مفاهيم اساسية:

• المدونات: "الجدر" ل مفاتيح API، المدونة لها منشورات و صفحات، بمثابة الحاوية container لمعلومات التعريف الخاصة بالمدونة مثل إسم المدونة و الوصف.
• المنشور: منشور المدونة هو العنصر المنشور الذي أنشأه مؤلف المدونة، 

   و من المفترض أن تكون هذه المنشورات في وقتها المناسب، تعكس الحدث أو الموضوع الذي يريد المدون الحديث عنه للعالم، فمن المعروف ان المنشورات تفقد اهميتها مع مرور الوقت.

• التعليقات: التعليق هو المكان الذي يتفاعل فيه الأشخاص مع ما كتبه المؤلف.
• الصفحات: الصفحة هي مكان للمحتوى الثابت، مثل معلومات السيرة الذاتية، أو طرق الاتصال بالمستخدم. هذه هي المعلومات الثابتة عمومًا التي لا تتغير كثيرًا.
• المستخدمون: المستخدم هو شخص يتفاعل مع Blogger ، سواء كان مؤلفًا أو مسؤولًا أو مجرد قارئ. بالنسبة للمدونات العامة ، قد يكون القراء مجهولون، ولكن في المدونات الخاصة ، يجب أن يتم التعرف على القارئ بواسطة Blogger.

نموذج البيانات API الخاصة بتطبيق بلوجر Blogger API data model.

المورد هو كيان بيانات فردي له معرف فريد. تعمل واجهة بلوجر جونسون آبي Blogger JSON API على خمسة أنواع من الموارد:

• مورد المدونات: يعرض مدونة
• مورد المنشورات: يعرض منشور، و كل مورد منشورات هو فرع من مورد مدونة.
• مورد التعليقات: يمثل تعليقًا على منشور معين ؛ كل مورد تعليقات هو تابع لمورد المنشورات
• مورد الصفحات: يمثل صفحة ثابتة ؛ كل مورد صفحات هو تابع لمورد المدونات.
• مورد المستخدم: يمثل مستخدمًا مجهول الهوية. يستخدم هذا لتحديد مؤلف الصفحة أو النشر أو التعليق.

نظرة عامة على العلاقات بين الموارد (بلوجر)

   يعتمد نمودج بيانات API لبلوجر على مجموعات تسمى "المجموعات" collections:

   مجموعة المدونات:

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

بخصوص برامج و تطبيقات