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 โทเค็น หรือทั้งสองอย่าง แล้วแต่ว่าตัวเลือกใดที่สะดวกที่สุดสำหรับคุณ

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

แอปพลิเคชันต้องใช้ 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 สำหรับ API JSON ของ Blogger:

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 ยังมีบล็อกส่วนตัวที่ต้องมีการตรวจสอบสิทธิ์

คำตอบ

ถ้าคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วย HTTP รหัสสถานะ 200 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

คำตอบ

ถ้าคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วย HTTP รหัสสถานะ 200 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 ยังมีบล็อกส่วนตัว ซึ่งจำเป็นต้องใช้ การตรวจสอบสิทธิ์

คำตอบ

ถ้าคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะตอบสนองด้วย HTTP รหัสสถานะ 200 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

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อเรียกความคิดเห็นจากบล็อกสาธารณะ ดังนั้น ไม่จำเป็นต้องระบุส่วนหัว HTTP ของ Authorization ในส่วนนี้ คำขอ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

เนื่องจากผู้ใช้ไม่จำเป็นต้องผ่านการตรวจสอบสิทธิ์เพื่อเรียกความคิดเห็นจากบล็อกสาธารณะ ดังนั้น ไม่จำเป็นต้องระบุส่วนหัว HTTP ของ Authorization ในส่วนนี้ คำขอ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 ของคอลเล็กชัน Pages จะมีรูปแบบดังนี้

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 ทรัพยากรของ Pages URI ของหน้าเว็บ แหล่งข้อมูลมีรูปแบบดังต่อไปนี้

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"
    }
  }
}

การทำงานกับผู้ใช้

การดึงข้อมูลผู้ใช้

คุณเรียกข้อมูลของผู้ใช้ได้โดยส่งคำขอ HTTP GET เป็น 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 */

หมายเหตุ: ผู้ใช้ต้องผ่านการตรวจสอบสิทธิ์เพื่อ แสดงข้อมูลของตนเอง ดังนั้นคุณต้องระบุ HTTP ของ Authorization ส่วนหัวที่มีคำขอ 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 มีอยู่ในเอกสารพารามิเตอร์ของระบบ