Blogger API: استخدام واجهة برمجة التطبيقات

تتيح لك واجهة برمجة تطبيقات Blogger دمج محتوى Blogger مع تطبيقك باستخدام واجهات برمجة تطبيقات REST. قبل البدء، عليك إعداد تفويض.

المقدمة

هذا المستند مخصّص لمطوّري البرامج الذين يريدون كتابة تطبيقات يمكنها التفاعل مع Blogger API. 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 نوعًا ما حسب نوع التطبيق الذي تكتبه. وتسري العملية التالية على كل أنواع التطبيقات:

  1. إذا احتاج التطبيق الدخول إلى بيانات المستخدِم، يطلب التطبيق من Google نطاقًا معينًا للدخول.
  2. يعرض Google شاشة الموافقة للمستخدم، ويطلب منه السماح لتطبيقك بطلب بعض بياناته.
  3. عند موافقة المستخدِم، يمنح Google تطبيقك رمز دخول قصير الأجل.
  4. يطلب تطبيقك بيانات المستخدِم، من خلال إرفاق رمز الدخول بالطلب.
  5. يعرض 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) لجمع المشاركة باستخدام نص مشاركة المشاركة:

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) لمورد المشاركة باستخدام نص نص المشاركة:

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) لمورد المشاركة باستخدام نص نص المشاركة:

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 على معلّمات النظام.