Blogger API ช่วยให้คุณผสานรวมเนื้อหาของ Blogger เข้ากับแอปพลิเคชันได้โดยใช้ REST API คุณต้องตั้งค่าการให้สิทธิ์ก่อนที่จะเริ่ม
บทนำ
เอกสารนี้มีไว้สําหรับนักพัฒนาซอฟต์แวร์ที่ต้องการเขียนแอปพลิเคชันที่โต้ตอบกับ Blogger API Blogger เป็นเครื่องมือสําหรับการสร้างเว็บไซต์ที่เปิดโอกาสให้ผู้คนเผยแพร่ความคิดของตนได้อย่างลงตัว
หากคุณไม่คุ้นเคยกับแนวคิดของ Blogger คุณควรอ่านการเริ่มต้นใช้งานก่อนเริ่มเขียนโค้ด
การให้สิทธิ์คําขอและระบุแอปพลิเคชันของคุณ
ทุกคําขอที่แอปพลิเคชันส่งไปยัง Blogger API จําเป็นต้องระบุแอปพลิเคชันของคุณให้ Google ทราบ สามารถระบุแอปพลิเคชันได้ 2 วิธี ได้แก่ การใช้โทเค็น OAuth 2.0 (ซึ่งให้สิทธิ์คําขอ) และ/หรือใช้คีย์ API ของแอปพลิเคชันด้วย 'ต่อไปนี้คือวิธีการพิจารณาว่าจะใช้ตัวเลือกใดต่อไปนี้
- ถ้าคําขอกําหนดให้มีการให้สิทธิ์ (เช่น คําขอข้อมูลส่วนตัวของแต่ละบุคคล) แอปพลิเคชันจะต้องมอบโทเค็น OAuth 2.0 ที่มีคําขอ แอปพลิเคชันนี้อาจมีคีย์ API ด้วยก็ได้ แต่ไม่จําเป็น
- หากคําขอไม่ได้กําหนดให้มีการให้สิทธิ์ (เช่น คําขอข้อมูลสาธารณะ) แอปพลิเคชันจะต้องมีคีย์ API หรือโทเค็น OAuth 2.0 หรือทั้ง 2 อย่าง ตัวเลือกใดที่คุณสะดวกที่สุด
เกี่ยวกับโปรโตคอลการให้สิทธิ์
แอปพลิเคชันต้องใช้ OAuth 2.0 เพื่อให้สิทธิ์คำขอ ระบบไม่รองรับโปรโตคอลการให้สิทธิ์อื่นๆ หากแอปพลิเคชันใช้ลงชื่อเข้าใช้ด้วย Google ระบบจะจัดการการให้สิทธิ์บางส่วนแก่คุณ
การให้สิทธิ์คำขอด้วย OAuth 2.0
คําขอที่ส่งไปยังข้อมูล API ที่ไม่ใช่แบบสาธารณะของผู้ใช้ใน Blogger จะต้องได้รับอนุญาตจากผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์
ขั้นตอนนี้จะอํานวยความสะดวกด้วยรหัสไคลเอ็นต์ OAuth
ขอรับรหัสไคลเอ็นต์ OAuthหรือสร้างข้อมูลในหน้าข้อมูลเข้าสู่ระบบ
รายละเอียดของกระบวนการให้สิทธิ์หรือ "ขั้นตอน" ของ OAuth 2.0 จะแตกต่างกันไปโดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่คุณเขียน แอปพลิเคชันทุกประเภทจะใช้กระบวนการทั่วไปต่อไปนี้
- เมื่อแอปพลิเคชันต้องการเข้าถึงข้อมูลผู้ใช้ แอปจะขอขอบเขตการเข้าถึงที่จำเป็นจาก Google
- 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
คําขอไปยัง Blogger API สําหรับข้อมูลสาธารณะต้องมีตัวระบุ ซึ่งอาจเป็นคีย์ API หรือโทเค็นเพื่อการเข้าถึงก็ได้
ดาวน์โหลดคีย์หรือสร้างข้อมูลในหน้าข้อมูลเข้าสู่ระบบ
เมื่อมีคีย์ API แล้ว แอปพลิเคชันจะเพิ่มพารามิเตอร์การค้นหา 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
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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
สําหรับคําขอบล็อกสาธารณะ แต่คุณต้องระบุคีย์ API
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" } }
พารามิเตอร์การค้นหามาตรฐาน
พารามิเตอร์การค้นหาต่อไปนี้สามารถใช้กับเมธอดและทรัพยากรทั้งหมดใน API ของ Blogger ได้
ดูพารามิเตอร์การค้นหาที่ใช้กับการดําเนินการทั้งหมดของ Blogger API ได้ที่พารามิเตอร์ระบบ