تتيح لك واجهة برمجة تطبيقات Blogger دمج محتوى Blogger مع تطبيقك باستخدام واجهات برمجة تطبيقات REST. قبل البدء، يجب إعداد التفويض.
مقدمة
هذا المستند مخصّص للمطورين الذين يريدون كتابة تطبيقات يمكنها التفاعل مع واجهة برمجة تطبيقات Blogger. Blogger هي أداة لإنشاء مواقع إلكترونية تتيح للأشخاص نشر أفكارهم بشكل مستمر.
إذا لم تكن معتادًا على مفاهيم Blogger، يجب أن تقرأ الخطوات الأولى قبل بدء الترميز.
السماح بالطلبات وتحديد تطبيقك
يحتاج كل طلب يرسله تطبيقك إلى واجهات برمجة تطبيقات Blogger إلى تعريف تطبيقك إلى Google. هناك طريقتان لتحديد تطبيقك: استخدام رمز OAuth 2.0 المميز (الذي يفوّض الطلب أيضًا) و/أو استخدام مفتاح واجهة برمجة التطبيقات للتطبيق. فيما يلي كيفية تحديد أي من هذه الخيارات يمكن استخدامه:
- إذا كان الطلب يتطلب الحصول على إذن (مثل طلب الحصول على بيانات خاصة لأحد الأفراد)، يجب أن يقدّم التطبيق رمز OAuth 2.0 المميز مع الطلب. قد يوفر التطبيق أيضًا مفتاح واجهة برمجة التطبيقات، ولكن لا يجب أن يقدمه.
- إذا كان الطلب لا يتطلب إذنًا (مثل طلب بيانات عامة)، يجب أن يوفر التطبيق إما مفتاح واجهة برمجة التطبيقات أو رمز OAuth 2.0 المميز أو كليهما، أيًا كان الخيار الأنسب لك.
لمحة عن بروتوكولات الموافقة على الطلبات
يجب أن يستخدم تطبيقك OAuth 2.0 للسماح بالطلبات. ولا يُسمح باستخدام أي بروتوكولات أخرى للموافقة على الطلبات. إذا كان تطبيقك يستخدم ميزة تسجيل الدخول باستخدام حساب Google، ستتم معالجة بعض جوانب عملية الموافقة على الطلبات نيابةً عنك.
الموافقة على الطلبات باستخدام OAuth 2.0
يجب أن يوافق مستخدم تمت مصادقته على الطلبات المُرسَلة إلى واجهات برمجة تطبيقات Blogger للحصول على بيانات المستخدمين غير العلنية.
ويتم تسهيل هذه العملية باستخدام معرِّف عميل OAuth.
الحصول على معرِّف عميل OAuthأو أنشئ حسابًا في صفحة بيانات الاعتماد.
تختلف تفاصيل عملية الموافقة على الطلبات لبروتوكول OAuth 2.0 نوعًا ما حسب نوع التطبيق الذي تكتبه. وتسري العملية التالية على كل أنواع التطبيقات:
- إذا احتاج التطبيق الدخول إلى بيانات المستخدِم، يطلب التطبيق من Google نطاقًا معينًا للدخول.
- يعرض Google شاشة الموافقة للمستخدم، ويطلب منه السماح لتطبيقك بطلب بعض بياناته.
- عند موافقة المستخدِم، يمنح Google تطبيقك رمز دخول قصير الأجل.
- يطلب تطبيقك بيانات المستخدِم، من خلال إرفاق رمز الدخول بالطلب.
- يعرض Google البيانات المطلوبة بعد تحققه من صلاحية طلبك والرمز المميز.
تستلزم بعض التدفقات إجراء خطوات إضافية، مثل استخدام رموز مميزة للتحديث للحصول على رموز دخول جديدة. لمزيد من المعلومات التفصيلية حول العمليات المتعلقة بمختلف أنواع التطبيقات، راجِع مستندات بروتوكول OAuth 2.0 في Google.
في ما يلي معلومات عن نطاق OAuth 2.0 لواجهات برمجة تطبيقات Blogger:
https://www.googleapis.com/auth/blogger
لطلب الدخول باستخدام بروتوكول OAuth 2.0، يحتاج التطبيق معلومات عن النطاق، بالإضافة إلى المعلومات التي يوفّرها Google عند تسجيل التطبيق (مثل معرِّف العميل وسر العميل).
نصيحة: يمكن لمكتبات عملاء Google APIs معالجة جزء من عملية السماح بالنيابة عنك. وتتوفّر هذه المكتبات للعديد من لغات البرمجة، ويمكنك الاطّلاع على صفحة المكتبات والنماذج للحصول على مزيد من التفاصيل.
الحصول على مفتاح واجهة برمجة التطبيقات واستخدامه
يجب أن تكون طلبات البيانات العامة إلى واجهات برمجة تطبيقات Blogger مصحوبةً بمعرّف يمكن أن يكون مفتاح واجهة برمجة تطبيقات أو رمزًا للوصول.
الحصول على مفتاحأو أنشئ حسابًا في صفحة بيانات الاعتماد.
بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكن لتطبيقك إلحاق معلَمة طلب البحث key=yourAPIKey
بجميع عناوين URL للطلبات.
يمكن تضمين مفتاح واجهة برمجة التطبيقات في عناوين URL بدون الحاجة إلى أيّ ترميز.
العمل مع المدونات
استرداد مدونة
يمكنك استرداد معلومات خاصة بمدوّنة معيّنة من خلال إرسال طلب HTTP GET
إلى معرّف الموارد المنتظم (URI) الخاص بالمدونة. يكون لمعرّف الموارد المنتظم (URI) الخاص بالمدونة التنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY
لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وبيانات المدونة:
{ "kind": "blogger#blog", "id": "2399953", "name": "Blogger Buzz", "description": "The Official Buzz from Blogger at Google", "published": "2007-04-23T22:17:29.261Z", "updated": "2011-08-02T06:01:15.941Z", "url": "http://buzz.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953", "posts": { "totalItems": 494, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts" }, "pages": { "totalItems": 2, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages" }, "locale": { "language": "en", "country": "", "variant": "" } }
استرداد مدونة من خلال عنوان URL الخاص بها
يمكنك استرداد مدوّنة باستخدام عنوان URL الخاص بها من خلال إرسال طلب HTTP GET
إلى معرّف الموارد المنتظم (URI) التالي باستخدام مَعلمة url
:
https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url
الطلب
https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
والتمثيل الكامل للمدونة
التي تم تحديدها:
{ "kind": "blogger#blog", "id": "3213900", "name": "Blogger Developers Network", "description": "The official Blogger Developers Network weblog.", "published": "2007-02-09T10:13:10-08:00", "updated": "2012-04-15T19:38:01-07:00", "url": "http://code.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900", "posts": { "totalItems": 55, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages" }, "locale": { "language": "en", "country": "US", "variant": "" } }
استرداد مدونات المستخدم
يمكنك استرداد قائمة بمدونات المستخدم عن طريق إرسال طلب HTTP GET
إلى معرّف الموارد المنتظم (URI) لمجموعة المدونات:
https://www.googleapis.com/blogger/v3/users/userId/blogs
الطلب
GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */
ملاحظة: يجب مصادقة المستخدم لإدراج مدوناته الخاصة، لذا عليك تقديم عنوان HTTP يتضمّن Authorization
مع طلب GET
.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
والتمثيل الكامل لقائمة مدونات
المستخدم:
{ "kind": "blogger#blogList", "items": [ { "kind": "blogger#blog", "id": "4967929378133675647", "name": "Brett's Test Blawg", "description": "", "published": "2010-10-06T23:33:31.662Z", "updated": "2011-08-08T06:50:02.005Z", "url": "http://brettmorgan-test-blawg.blogspot.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647", "posts": { "totalItems": 13, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages" }, "locale": { "language": "en", "country": "", "variant": "" } } ] }
التعامل مع المشاركات
استرداد المشاركات من مدونة
يمكنك استرداد قائمة بالمشاركات من مدونة معيّنة من خلال إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمجموعة المشاركات. يكون معرف الموارد المنتظم (URI) لمجموعة
مشاركات بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts
الطلب
يُرجى الاطّلاع على المثال أدناه:
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY
لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وقائمة بالمشاركات:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ", "items": [ { "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }, { "kind": "blogger#post", "id": "6069922188027612413", elided for readability } ] }
استرداد مشاركة محددة
يمكنك استرداد مشاركة محدّدة من مدونة من خلال إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمورد المشاركات. يكون معرف الموارد المنتظم (URI)
لمورد المشاركات بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY
لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
البحث عن مشاركة
يمكنك البحث عن مشاركات من مدوّنة من خلال إرسال طلب GET
إلى
معرّف الموارد المنتظم (URI) للبحث عن المشاركات باستخدام معلَمة طلب البحث q:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY
لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ", "items": [ { "kind": "blogger#post", "id": "1387873546480002228", "blog": { "id": "3213900" }, "published": "2012-03-23T01:58:00-07:00", "updated": "2012-03-23T01:58:12-07:00", "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228", "title": "Blogger Documentation has moved to developers.google.com", "content": "content elided for readability", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments" } }, ... ] }
إضافة مشاركة
يمكنك إضافة مشاركة لمدوّنة من خلال إرسال طلب POST
إلى معرّف الموارد المنتظم (URI) الخاص بمجموعة المشاركات مع تضمين نص JSON للمشاركة:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/
الطلب
POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/ Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "blog": { "id": "8070105920543249955" }, "title": "A new post", "content": "With <b>exciting</b> content..." }
يجب المصادقة عليك لإنشاء مشاركة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "A new post", "content": "With <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
حذف مشاركة
يمكنك حذف مشاركة مدونة من خلال إرسال طلب DELETE
إلى معرّف الموارد المنتظم (URI) لمورد المشاركة:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
الطلب
يُرجى الاطّلاع على المثال أدناه:
DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058 Authorization: /* OAuth 2.0 token here */
يجب المصادقة عليك لحذف مشاركة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
.
استرداد مشاركة حسب مسارها
يمكنك استرداد مشاركة من مدوّنة من خلال إرسال طلب GET
إلى
معرّف الموارد المنتظم (URI) لمسار المشاركات باستخدام معلَمة path
. ويكون معرّف الموارد المنتظم (URI) الخاص بطلب المشاركات حسب المسار بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path
الطلب
https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY
لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
تعديل مشاركة
يمكنك تعديل مشاركة مدونة من خلال إرسال طلب PUT
إلى معرّف الموارد المنتظم (URI) لمورد المشاركة مع تضمين نص JSON الخاص بالمشاركة:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
الطلب
PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "id": "3445355871727114160", "blog": { "id": "8070105920543249955" }, "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160", "title": "An updated post", "content": "With really <b>exciting</b> content..." }
يجب أن تتم مصادقتك لتعديل مشاركة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With really <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
تعديل مشاركة تتضمّن دلالات رموز تصحيح
يمكنك تعديل مشاركة باستخدام دلالات رموز التصحيح عن طريق إرسال طلب PATCH
إلى معرّف الموارد المنتظم (URI) لمورد المشاركة مع تضمين نص JSON للمشاركة:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
الطلب
يُرجى الاطّلاع على المثال أدناه:
PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "content": "With absolutely <b>fabulous</b> content..." }
يجب أن تتم مصادقتك لتعديل مشاركة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ومحتوى المشاركة:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With absolutely <b>fabulous</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
التعامل مع التعليقات
استرداد التعليقات على مشاركة
يمكنك استرداد قائمة بالتعليقات على مشاركة من خلال إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمجموعة التعليقات. يكون معرف الموارد المنتظم (URI)
لمجموعة التعليقات بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY
"لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وقائمة التعليقات:
{ "kind": "blogger#commentList", "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ", "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ", "items": [ { "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }, { "kind": "blogger#comment", "id": "400101178920857170", elided for readability } ] }
استرداد تعليق معين
يمكنك استرداد تعليق محدّد من مشاركة عن طريق إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمورد التعليقات. يكون معرف الموارد المنتظم (URI)
لمورد التعليقات بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY
"لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وبيانات التعليق:
{ "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }
التعامل مع الصفحات
استرداد صفحات المدونة
يمكنك استرداد قائمة بصفحات إحدى المدونات من خلال إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمجموعة الصفحات. يكون معرف الموارد المنتظم (URI)
لمجموعة صفحات بالتنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY
"لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وقائمة الصفحات:
{ "kind": "blogger#pageList", "items": [ { "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } } ] }
استرداد صفحة محددة
يمكنك استرداد صفحة معيّنة من مدونة من خلال إرسال طلب GET
إلى معرّف الموارد المنتظم (URI) لمورد الصفحات. يكون لمعرف الموارد المنتظم (URI)
لمورد الصفحات التنسيق التالي:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId
الطلب
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY
"لا يحتاج المستخدم إلى المصادقة لاسترداد مدونة عامة. ولا يحتاج التطبيق إلى تضمين عنوان HTTP Authorization
لطلب مدوّنة متاحة للجميع، ولكن عليك تقديم مفتاح واجهة برمجة التطبيقات.
لدى Blogger أيضًا مدونات خاصة تتطلب المصادقة.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
وبيانات الصفحة:
{ "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } }
العمل مع المستخدمين
استرداد مستخدم
يمكنك استرداد معلومات المستخدم عن طريق إرسال طلب HTTP GET
إلى معرّف الموارد المنتظم (URI) لمورد المستخدمين:
https://www.googleapis.com/blogger/v3/users/userId
الطلب
GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */
ملاحظة: يجب مصادقة المستخدم لإدراج معلوماته، لذا عليك تقديم عنوان HTTP يتضمّن Authorization
مع طلب GET
.
الإجابة
إذا نجح الطلب، يستجيب الخادم برمز حالة HTTP
200 OK
ورابط إلى قائمة مدوّنات
المستخدم:
{ "kind": "blogger#user", "id": "901569848744", "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744", "blogs": { "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs" } }
مَعلمات طلب البحث العادية
يمكن استخدام معلَمات طلب البحث التالية مع جميع الطرق وجميع الموارد في واجهات برمجة تطبيقات Blogger.
يتم توثيق مَعلمات طلب البحث التي تنطبق على جميع عمليات واجهات برمجة تطبيقات Blogger في مَعلمات النظام.