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

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

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) الخاص بمجموعة المشاركات مع تضمين نص 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 في مَعلمات النظام.