Blogger API به شما امکان می دهد با استفاده از REST API ها، محتوای بلاگر را با برنامه خود ادغام کنید. قبل از شروع، باید مجوز را تنظیم کنید.
مقدمه
این سند برای توسعه دهندگانی است که می خواهند برنامه هایی بنویسند که بتوانند با Blogger API تعامل داشته باشند. بلاگر ابزاری برای ایجاد وب سایت هایی است که به افراد اجازه می دهد افکار خود را به طور مداوم منتشر کنند.
اگر با مفاهیم بلاگر آشنا نیستید، باید قبل از شروع به کدنویسی، شروع به کار را بخوانید.
تأیید درخواست ها و شناسایی درخواست شما
هر درخواستی که برنامه شما به APIهای Blogger ارسال می کند باید برنامه شما را برای Google شناسایی کند. دو راه برای شناسایی برنامه شما وجود دارد: استفاده از یک توکن OAuth 2.0 (که درخواست را نیز مجاز می کند) و/یا استفاده از کلید API برنامه . در اینجا نحوه تعیین اینکه کدام یک از این گزینه ها استفاده شود آورده شده است:
- اگر درخواست نیاز به مجوز داشته باشد (مانند درخواست برای داده های خصوصی یک فرد)، برنامه باید یک توکن OAuth 2.0 را همراه با درخواست ارائه کند. برنامه ممکن است کلید API را نیز ارائه کند، اما لازم نیست.
- اگر درخواست به مجوز نیاز ندارد (مانند درخواست برای داده‌های عمومی)، برنامه باید یا کلید API یا یک نشانه OAuth 2.0 یا هر دو را ارائه دهد - هر گزینه ای که برای شما راحت تر است.
درباره پروتکل های مجوز
برنامه شما باید از OAuth 2.0 برای تأیید درخواست ها استفاده کند. هیچ پروتکل مجوز دیگری پشتیبانی نمی شود. اگر برنامه شما از ورود به سیستم با Google استفاده می کند، برخی از جنبه های مجوز برای شما انجام می شود.
تأیید درخواست ها با OAuth 2.0
درخواست‌ها به APIهای بلاگر برای داده‌های کاربر غیرعمومی باید توسط یک کاربر تأیید شده مجاز باشد.
این فرآیند با شناسه مشتری OAuth تسهیل می شود.
شناسه مشتری OAuth دریافت کنیدیا در صفحه اعتبارنامه ایجاد کنید.
جزئیات فرآیند مجوز یا "جریان" برای OAuth 2.0 بسته به نوع برنامه ای که می نویسید تا حدودی متفاوت است. فرآیند کلی زیر برای همه انواع برنامه ها اعمال می شود:
- هنگامی که برنامه شما نیاز به دسترسی به داده های کاربر دارد، از Google دامنه دسترسی خاصی را می خواهد.
- Google یک صفحه رضایت به کاربر نمایش می دهد و از او می خواهد تا به برنامه شما اجازه دهد تا برخی از داده های خود را درخواست کند.
- اگر کاربر تأیید کند، گوگل به برنامه شما یک رمز دسترسی کوتاه مدت می دهد.
- برنامه شما با پیوست کردن رمز دسترسی به درخواست، داده های کاربر را درخواست می کند.
- اگر Google تشخیص دهد که درخواست شما و رمز معتبر هستند، داده‌های درخواستی را برمی‌گرداند.
برخی از جریان‌ها شامل مراحل اضافی هستند، مانند استفاده از نشانه‌های تازه‌سازی برای به دست آوردن نشانه‌های دسترسی جدید. برای اطلاعات دقیق درباره جریان‌ها برای انواع مختلف برنامه‌ها، به اسناد OAuth 2.0 Google مراجعه کنید.
در اینجا اطلاعات محدوده OAuth 2.0 برای APIهای Blogger آمده است:
https://www.googleapis.com/auth/blogger
برای درخواست دسترسی با استفاده از OAuth 2.0، برنامه شما به اطلاعات محدوده و همچنین اطلاعاتی که Google هنگام ثبت برنامه خود ارائه می دهد (مانند شناسه مشتری و رمز سرویس گیرنده) نیاز دارد.
نکته: کتابخانه های سرویس گیرنده Google APIs می توانند برخی از فرآیندهای مجوز را برای شما انجام دهند. آنها برای انواع زبان های برنامه نویسی در دسترس هستند. برای جزئیات بیشتر صفحه را با کتابخانه ها و نمونه ها بررسی کنید.
به دست آوردن و استفاده از یک کلید API
درخواست‌های APIهای بلاگر برای داده‌های عمومی باید با یک شناسه همراه باشد که می‌تواند یک کلید API یا یک نشانه دسترسی باشد.
یک کلید دریافت کنیدیا در صفحه اعتبارنامه ایجاد کنید.
بعد از اینکه یک کلید API داشتید، برنامه شما می تواند پارامتر query key= yourAPIKey را به همه URL های درخواستی اضافه کند.
کلید API برای جاسازی در 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 برای درخواست وبلاگ عمومی ندارد. با این حال، شما نیاز به ارائه کلید API دارید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد. با این حال، شما نیاز به ارائه کلید API دارید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد. با این حال، شما نیاز به ارائه کلید API دارید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 جستجوی پست با پارامتر query 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 برای درخواست وبلاگ عمومی ندارد. با این حال، شما نیاز به ارائه کلید API دارید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 bypath پست ها با پارامتر 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 برای درخواست وبلاگ عمومی ندارد. با این حال، شما نیاز به ارائه کلید API دارید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد؛ با این حال، شما باید کلید API را ارائه دهید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با یک کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد؛ با این حال، شما باید کلید API را ارائه دهید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با یک کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد؛ با این حال، شما باید کلید API را ارائه دهید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با کد وضعیت 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 برای درخواست وبلاگ عمومی ندارد؛ با این حال، شما باید کلید API را ارائه دهید.
بلاگر همچنین دارای وبلاگ های خصوصی است که نیاز به احراز هویت دارند.
واکنش
اگر درخواست با موفقیت انجام شود، سرور با یک کد وضعیت 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"
}
}
پارامترهای پرس و جو استاندارد
پارامترهای پرس و جو زیر را می توان با همه روش ها و همه منابع موجود در API های بلاگر استفاده کرد.
پارامترهای پرس و جو که برای همه عملیات APIهای Blogger اعمال می شوند در پارامترهای سیستم مستند می شوند.