Blogger API: การใช้ API

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 จะแตกต่างกันไปโดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่คุณเขียน แอปพลิเคชันทุกประเภทจะใช้กระบวนการทั่วไปต่อไปนี้

1. เมื่อแอปพลิเคชันต้องการเข้าถึงข้อมูลผู้ใช้ แอปจะขอขอบเขตการเข้าถึงที่จำเป็นจาก Google
2. Google จะแสดงหน้าจอขอคำยินยอมแก่ผู้ใช้เพื่อขอให้ผู้ใช้ให้สิทธิ์แอปพลิเคชันของคุณในการขอข้อมูลบางอย่างของผู้ใช้
3. หากผู้ใช้อนุมัติ Google จะให้โทเค็นเพื่อการเข้าถึงที่มีอายุชั่วคราวแก่แอปพลิเคชันของคุณ
4. แอปพลิเคชันขอข้อมูลผู้ใช้โดยแนบโทเค็นเพื่อการเข้าถึงไปกับคำขอ
5. หาก 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 ได้ที่พารามิเตอร์ระบบ