Blogger JSON API: การใช้ API

สำคัญ เราจะหยุดรองรับ JSON API เวอร์ชัน 2.0 ในวันที่ 30 กันยายน 2024 โปรดอัปเดตแอปพลิเคชันที่อาศัย JSON API เวอร์ชัน 2.0 เป็น API เวอร์ชันล่าสุดเพื่อให้แอปพลิเคชันทำงานต่อไปได้ หากต้องการใช้เวอร์ชันล่าสุด ให้ใช้ลิงก์ในแถบนําทางด้านซ้าย

เอกสารนี้อธิบายวิธีใช้ฟีเจอร์ทั่วไปของ Blogger JSON API โดยใช้รูปแบบการเรียก RESTful

เนื้อหา

1. ข้อมูลเบื้องต้น
   1. การให้สิทธิ์คำขอและการระบุแอปพลิเคชันของคุณ
2. การทํางานกับบล็อก
   1. การดึงข้อมูลบล็อก
   2. การดึงข้อมูลบล็อกของผู้ใช้
3. การทํางานกับโพสต์
   1. การดึงข้อมูลโพสต์สำหรับบล็อก
   2. การดึงข้อมูลโพสต์ที่เฉพาะเจาะจง
4. การทำงานกับความคิดเห็น
   1. การดึงข้อมูลความคิดเห็นของโพสต์
   2. การดึงข้อมูลความคิดเห็นที่เฉพาะเจาะจง
5. การทํางานกับหน้าเว็บ
   1. การดึงข้อมูลหน้าเว็บสําหรับบล็อก
   2. การดึงข้อมูลหน้าเว็บที่เฉพาะเจาะจง
6. การทํางานร่วมกับผู้ใช้
   1. การเรียกข้อมูลผู้ใช้
7. พารามิเตอร์การค้นหามาตรฐาน

บทนำ

เอกสารนี้มีไว้สำหรับนักพัฒนาแอปที่ต้องการเขียนแอปพลิเคชันที่โต้ตอบกับ Blogger JSON API ได้ Blogger เป็นเครื่องมือสำหรับการสร้างเว็บไซต์ที่ช่วยให้ผู้คนเผยแพร่ความคิดของตนได้อย่างต่อเนื่อง

หากคุณไม่คุ้นเคยกับแนวคิดของ Blogger คุณควรอ่านการเริ่มต้นใช้งานก่อนเริ่มเขียนโค้ด

การให้สิทธิ์คำขอและการระบุแอปพลิเคชัน

ทุกคำขอที่แอปพลิเคชันส่งไปยัง Blogger JSON API จะต้องระบุแอปพลิเคชันของคุณให้ Google ทราบ คุณสามารถระบุแอปพลิเคชันได้ด้วย 2 วิธี ได้แก่ การใช้โทเค็น OAuth 2.0 (ซึ่งให้สิทธิ์คําขอด้วย) และ/หรือการใช้คีย์ API ของแอปพลิเคชัน วิธีเลือกตัวเลือกที่จะใช้มีดังนี้

• หากคำขอต้องมีการให้สิทธิ์ (เช่น คำขอข้อมูลส่วนตัวของบุคคล) แอปพลิเคชันต้องระบุโทเค็น OAuth 2.0 มาพร้อมกับคำขอ แอปพลิเคชันอาจระบุคีย์ API ด้วย แต่ไม่จำเป็นต้องระบุ
• หากคำขอไม่จําเป็นต้องได้รับสิทธิ์ (เช่น คำขอข้อมูลสาธารณะ) แอปพลิเคชันต้องระบุคีย์ API หรือโทเค็น OAuth 2.0 หรือทั้ง 2 อย่าง แล้วแต่ว่าตัวเลือกใดจะสะดวกสําหรับคุณมากที่สุด

เกี่ยวกับโปรโตคอลการให้สิทธิ์

แอปพลิเคชันต้องใช้ OAuth 2.0 เพื่อให้สิทธิ์คำขอ ระบบไม่รองรับโปรโตคอลการให้สิทธิ์อื่นๆ

หมายเหตุ: ปัจจุบัน Blogger JSON API ไม่รองรับการเข้าสู่ระบบพร้อมกันกับการส่งคำขอการเข้าถึงข้อมูล (แบบผสม) หรือการมอบสิทธิ์ทั่วทั้งโดเมน (2LO)

การให้สิทธิ์คำขอด้วย OAuth 2.0

คำขอข้อมูลผู้ใช้ที่ไม่ใช่แบบสาธารณะจาก Blogger JSON API จะต้องได้รับสิทธิ์จากผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

รายละเอียดของกระบวนการให้สิทธิ์หรือ "ขั้นตอน" ของ OAuth 2.0 จะแตกต่างกันไปโดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่คุณเขียน แอปพลิเคชันทุกประเภทจะใช้กระบวนการทั่วไปต่อไปนี้

1. เมื่อสร้างแอปพลิเคชัน คุณจะลงทะเบียนแอปกับ Google จากนั้น Google จะให้ข้อมูลที่คุณต้องใช้ในภายหลัง เช่น รหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์
2. เปิดใช้งาน Blogger JSON API ในแผงบริการของคอนโซล Google API (หากไม่เห็นรายการดังกล่าวในคอนโซล ให้ข้ามขั้นตอนนี้ไป)
3. เมื่อแอปพลิเคชันต้องการเข้าถึงข้อมูลผู้ใช้ แอปจะขอขอบเขตการเข้าถึงที่จำเป็นจาก Google
4. Google จะแสดงกล่องโต้ตอบ OAuth แก่ผู้ใช้เพื่อขอให้ผู้ใช้ให้สิทธิ์แอปพลิเคชันของคุณในการขอข้อมูลบางอย่างของผู้ใช้
5. หากผู้ใช้อนุมัติ Google จะให้โทเค็นเพื่อการเข้าถึงที่มีอายุชั่วคราวแก่แอปพลิเคชันของคุณ
6. แอปพลิเคชันขอข้อมูลผู้ใช้โดยแนบโทเค็นการเข้าถึงไปกับคำขอ
7. หาก Google ตัดสินว่าคำขอและโทเค็นของคุณถูกต้อง ระบบจะแสดงข้อมูลที่ขอ

บางกระบวนการจะมีขั้นตอนเพิ่มเติม เช่น การใช้โทเค็นการรีเฟรชเพื่อขอโทเค็นเพื่อการเข้าถึงใหม่ ดูข้อมูลอย่างละเอียดเกี่ยวกับกระบวนการของแอปพลิเคชันประเภทต่างๆ ได้ที่เอกสารประกอบเกี่ยวกับ OAuth 2.0 ของ Google

ข้อมูลขอบเขตของ OAuth 2.0 สำหรับ Blogger JSON API มีดังต่อไปนี้

https://www.googleapis.com/auth/blogger

หากต้องการขอสิทธิ์โดยใช้ OAuth 2.0 แอปพลิเคชันของคุณต้องมีข้อมูลขอบเขต รวมถึงข้อมูลที่ Google ให้คุณระหว่างการลงทะเบียนแอปพลิเคชัน (เช่น รหัสไคลเอ็นต์และ/หรือรหัสลับไคลเอ็นต์)

เคล็ดลับ: ไลบรารีของไคลเอ็นต์ Google APIs จัดการขั้นตอนการให้สิทธิ์บางส่วนให้คุณได้ ไลบรารีเหล่านี้พร้อมให้บริการเป็นภาษาโปรแกรมต่างๆ โปรดดูรายละเอียดเพิ่มเติมที่หน้าไลบรารีและตัวอย่าง

การรับและใช้คีย์ API

คำขอข้อมูลสาธารณะจาก Blogger JSON API ต้องมีตัวระบุ ซึ่งอาจเป็นคีย์ API หรือโทเค็นการตรวจสอบสิทธิ์

หากต้องการรับคีย์ API ให้ไปที่คอนโซล API ในแผงบริการ ให้เปิดใช้งาน [api_name] หากข้อกำหนดในการให้บริการปรากฏขึ้น ให้อ่านและยอมรับ

ถัดไป ให้ไปที่แผงการเข้าถึง API คีย์ API จะอยู่ใกล้กับด้านล่างของแผงนั้น ในส่วน "การเข้าถึง API แบบง่าย"

หลังจากมีคีย์ API แล้ว แอปพลิเคชันจะเพิ่มพารามิเตอร์การค้นหา key=yourAPIKey ต่อท้าย URL คำขอทั้งหมดได้

คีย์ API ปลอดภัยสำหรับการฝังใน URL โดยไม่จำเป็นต้องเข้ารหัส

การใช้งานบล็อก

การเรียกข้อมูลบล็อก

คุณสามารถดึงข้อมูลสำหรับทรัพยากรบล็อกที่เฉพาะเจาะจงได้โดยส่งคำขอ HTTPGET ไปยัง URI ของบล็อก URI ของทรัพยากรบล็อกมีรูปแบบดังนี้

https://www.googleapis.com/blogger/v2/blogs/blogId

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/2399953&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อเรียกข้อมูลบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว Authorization HTTP กับคำขอ GETนี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และข้อมูลบล็อก ดังนี้

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/v2/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

การเรียกข้อมูลบล็อกของผู้ใช้

คุณสามารถเรียกข้อมูลรายการบล็อกของผู้ใช้ได้โดยส่งGETคําขอ HTTP ไปที่ URI ของคอลเล็กชันบล็อก ดังนี้

https://www.googleapis.com/blogger/v2/users/userId/blogs

ส่งคำขอ

ต่อไปนี้คือตัวอย่างคำขอ GET ที่แสดงรายการบล็อกของผู้ใช้

GET https://www.googleapis.com/blogger/v2/users/self/blogs
Authorization: /* OAuth 2.0 token here */

หมายเหตุ: ผู้ใช้ต้องได้รับการตรวจสอบสิทธิ์เพื่อแสดงบล็อกของตนเอง คุณจึงต้องระบุส่วนหัว Authorization HTTP กับคำขอ GET

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และการแสดงรายการบล็อกของผู้ใช้อย่างเต็มรูปแบบ ดังนี้

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/v2/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

การทำงานกับโพสต์

การดึงข้อมูลโพสต์จากบล็อก

คุณสามารถดึงข้อมูลรายการโพสต์จากบล็อกหนึ่งๆ ได้โดยส่งคำขอ GET ไปยัง URI ของคอลเล็กชันโพสต์ URI สำหรับคอลเล็กชันโพสต์มีรูปแบบดังนี้

https://www.googleapis.com/blogger/v2/blogs/blogId/posts

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อดึงข้อมูลโพสต์จากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว Authorization HTTP กับคำขอ GET นี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และรายการโพสต์

200 OK

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "prevPageToken": "CgkIChDBwrK3mCYQ0b2SAQ",
  "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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

การดึงข้อมูลโพสต์ที่เฉพาะเจาะจง

คุณดึงข้อมูลโพสต์ที่เฉพาะเจาะจงจากบล็อกได้โดยส่งGETคำขอไปยัง URI แหล่งข้อมูลของโพสต์ URI ของทรัพยากรโพสต์มีรูปแบบดังนี้

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อดึงข้อมูลโพสต์จากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว Authorization HTTP กับคำขอ GET นี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และเนื้อหาของโพสต์

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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
  }
}

การทำงานกับความคิดเห็น

การดึงข้อมูลความคิดเห็นของโพสต์

คุณสามารถดึงข้อมูลรายการความคิดเห็นของโพสต์ได้โดยส่งGETคําขอไปยัง URI ของคอลเล็กชันความคิดเห็น URI สำหรับคอลเล็กชันความคิดเห็นมีรูปแบบดังนี้

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องตรวจสอบสิทธิ์เพื่อดึงข้อมูลความคิดเห็นจากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว Authorization HTTP กับคำขอ GETนี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และรายการความคิดเห็น ดังนี้

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/v2/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/v2/blogs/blogId/posts/postId/comments/commentId

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องตรวจสอบสิทธิ์เพื่อดึงข้อมูลความคิดเห็นจากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว Authorization HTTP กับคำขอ GETนี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และข้อมูลความคิดเห็น ดังนี้

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/v2/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/v2/blogs/blogId/pages

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อดึงข้อมูลหน้าเว็บจากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว HTTP Authorization กับคำขอ GET นี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และรายการหน้าเว็บ ดังนี้

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/v2/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 ของทรัพยากร Pages มีรูปแบบดังนี้

https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId

ส่งคำขอ

มีตัวอย่างดังต่อไปนี้

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages/273541696466681878&key=YOUR-API-KEY

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อดึงข้อมูลหน้าเว็บจากบล็อกสาธารณะ คุณจึงไม่จำเป็นต้องระบุส่วนหัว HTTP Authorization กับคำขอ GET นี้ แต่หากไม่ระบุส่วนหัวดังกล่าว คุณจะต้องระบุคีย์ API

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และข้อมูลหน้าเว็บ ดังนี้

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/v2/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คําขอ HTTP ไปที่ URI แหล่งข้อมูลของผู้ใช้

https://www.googleapis.com/blogger/v2/users/userId

ส่งคำขอ

ต่อไปนี้คือตัวอย่างคำขอ GET ที่แสดงรายการบล็อกของผู้ใช้

GET https://www.googleapis.com/blogger/v2/users/self
Authorization: /* OAuth 2.0 token here */

หมายเหตุ: ผู้ใช้ต้องได้รับการตรวจสอบสิทธิ์เพื่อแสดงข้อมูลของตนเอง คุณจึงต้องระบุส่วนหัว Authorization HTTP กับคำขอ GET

คำตอบ

หากคำขอสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP200 OK และลิงก์ไปยังรายการบล็อกของผู้ใช้

200 OK

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744/blogs"
  }
}

พารามิเตอร์การค้นหามาตรฐาน

พารามิเตอร์การค้นหาต่อไปนี้ใช้ได้กับเมธอดและทรัพยากรทั้งหมดใน Blogger API

พารามิเตอร์การค้นหาที่ใช้กับการดำเนินการทั้งหมดของ Blogger API มีอยู่ในเอกสารพารามิเตอร์ของระบบ