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 APIs (หากไม่มีอยู่ใน Console ให้ข้ามขั้นตอนนี้)
  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 โดยไม่จำเป็นต้องมีการเข้ารหัสใดๆ

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

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

คุณเรียกดูข้อมูลสำหรับทรัพยากรของบล็อกบางรายการได้โดยส่งคำขอ HTTP GET ไปยัง 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": ""
  }
}

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

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

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

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

นอกจากนี้ Blogger ยังมีบล็อกส่วนตัว ซึ่งต้องมี การตรวจสอบความถูกต้อง

คำตอบ

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

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

คำตอบ

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

คำตอบ

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

คำตอบ

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

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 ยังมีบล็อกส่วนตัว ซึ่งต้องมี การตรวจสอบความถูกต้อง

คำตอบ

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

คำตอบ

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