API Blogger cho phép bạn tích hợp nội dung của Blogger với ứng dụng bằng cách sử dụng các API REST. Trước khi bắt đầu, bạn cần thiết lập yêu cầu uỷ quyền.
Giới thiệu
Tài liệu này dành cho các nhà phát triển muốn viết các ứng dụng có thể tương tác với API Blogger. Blogger là một công cụ tạo trang web cho phép mọi người xuất bản suy nghĩ của họ trên một nền tảng đang diễn ra.
Nếu chưa hiểu rõ các khái niệm của Blogger, bạn nên đọc Bắt đầu trước khi bắt đầu viết mã.
Uỷ quyền cho yêu cầu và nhận dạng ứng dụng của bạn
Mọi yêu cầu mà ứng dụng của bạn gửi tới API Blogger cần phải xác định ứng dụng của bạn cho Google. Có 2 cách để xác định ứng dụng của bạn: sử dụng mã thông báo OAuth 2.0 (cũng cho phép yêu cầu) và/hoặc sử dụng khoá API của ứng dụng. Dưới đây là cách xác định nên sử dụng tuỳ chọn nào trong số đó:
- Nếu yêu cầu cần được uỷ quyền (chẳng hạn như yêu cầu dữ liệu cá nhân của một cá nhân) thì ứng dụng phải cung cấp mã OAuth 2.0 cùng với yêu cầu đó. Ứng dụng cũng có thể cung cấp khoá API (không bắt buộc).
- Nếu yêu cầu đó không đòi hỏi việc uỷ quyền (chẳng hạn như yêu cầu đối với dữ liệu công khai) thì ứng dụng phải cung cấp khoá API hoặc mã OAuth 2.0, hoặc cả hai – tuỳ theo phương án nào thuận tiện nhất cho bạn.
Giới thiệu về giao thức cấp phép
Ứng dụng của bạn phải sử dụng OAuth 2.0 để cấp phép các yêu cầu. Chúng tôi không hỗ trợ giao thức cấp phép nào khác. Nếu ứng dụng của bạn sử dụng chức năng Đăng nhập bằng Google, thì Google sẽ giúp bạn xử lý một số bước trong quá trình cấp phép.
Cấp phép cho các yêu cầu bằng OAuth 2.0
Các yêu cầu gửi dữ liệu không công khai của người dùng đến API Blogger phải được người dùng đã xác thực cấp phép.
Quá trình này được thực hiện bằng ID ứng dụng khách OAuth.
Nhận mã ứng dụng OAuthHoặc tạo một mã trong trang Thông tin đăng nhập.
Các chi tiết của quy trình cấp phép đối với OAuth 2.0 sẽ khác nhau đôi chút tuỳ thuộc vào loại ứng dụng bạn đang viết. Quy trình chung sau đây áp dụng cho tất cả các loại ứng dụng:
- Khi cần quyền truy cập vào dữ liệu người dùng, ứng dụng sẽ yêu cầu Google cung cấp phạm vi truy cập cụ thể.
- Google hiển thị màn hình yêu cầu sự đồng ý cho người dùng để hỏi xem họ có cho phép ứng dụng của bạn yêu cầu một số dữ liệu của họ hay không.
- Nếu người dùng đồng ý, thì Google sẽ cấp cho ứng dụng của bạn một mã truy cập ngắn hạn.
- Sau đó, ứng dụng yêu cầu dữ liệu người dùng và đính kèm mã truy cập trong yêu cầu.
- Nếu xác định rằng yêu cầu của bạn và mã này là hợp lệ, Google sẽ trả về dữ liệu mà ứng dụng yêu cầu.
Một số quy trình cấp phép có các bước bổ sung khác, chẳng hạn như sử dụng mã làm mới để lấy mã truy cập mới. Để biết thông tin chi tiết về quy trình cho các loại ứng dụng khác nhau, hãy xem tài liệu về OAuth 2.0 của Google.
Dưới đây là thông tin về phạm vi của OAuth 2.0 cho các API Blogger:
https://www.googleapis.com/auth/blogger
Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cần thông tin về mức truy cập, cũng như thông tin mà Google cung cấp khi bạn đăng ký ứng dụng của mình (chẳng hạn như mã ứng dụng khách và mật khẩu ứng dụng khách).
Mẹo: Thư viện ứng dụng API Google có thể xử lý một số bước trong quy trình cấp phép cho bạn. Thư viện này được cung cấp bằng nhiều ngôn ngữ lập trình. Hãy xem trang về các thư viện và mẫu để biết thêm chi tiết.
Nhận và sử dụng khoá API
Các yêu cầu về dữ liệu công khai đối với API Blogger phải đi kèm với một giá trị nhận dạng, có thể là khoá API hoặc mã truy cập.
Mua khoáHoặc tạo một mã trong trang Thông tin đăng nhập.
Sau khi bạn có khoá API, ứng dụng của bạn có thể thêm tham số truy vấn key=yourAPIKey vào tất cả các URL yêu cầu.
Khoá API an toàn để nhúng trong URL và không cần sử dụng phương thức mã hoá nào.
Làm việc với blog
Truy xuất blog
Bạn có thể truy xuất thông tin cho một blog cụ thể bằng cách gửi yêu cầu HTTP GET đến URI của blog. URI cho một blog có định dạng sau:
https://www.googleapis.com/blogger/v3/blogs/blogId
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY
Người dùng không cần được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và dữ liệu blog:
{
"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": ""
}
}
Truy xuất blog theo URL
Bạn có thể truy xuất blog qua URL của blog đó bằng cách gửi yêu cầu HTTP GET đến URI sau đây với tham số url:
https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url
Yêu cầu
https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung đại diện đầy đủ của blog đã xác định:
{
"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": ""
}
}
Truy xuất blog của người dùng
Bạn có thể truy xuất danh sách blog của người dùng bằng cách gửi yêu cầu HTTP GET đến URI bộ sưu tập blog:
https://www.googleapis.com/blogger/v3/users/userId/blogs
Yêu cầu
GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */
Lưu ý: Người dùng phải được xác thực để liệt kê blog của riêng họ, vì vậy, bạn phải cung cấp tiêu đề HTTP Authorization cùng với yêu cầu GET.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và bản trình bày đầy đủ danh sách blog của người dùng:
{
"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": ""
}
}
]
}
Cách xử lý bài đăng
Truy xuất bài đăng từ blog
Bạn có thể truy xuất danh sách các bài đăng của một blog nhất định bằng cách gửi yêu cầu GET đến URI bộ sưu tập bài đăng. URI cho bộ sưu tập bài đăng có định dạng sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Yêu cầu
Dưới đây là ví dụ:
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY
Người dùng không cần được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và danh sách các bài đăng:
{
"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
}
]
}
Truy xuất một bài đăng cụ thể
Bạn có thể truy xuất một bài đăng cụ thể từ một blog bằng cách gửi yêu cầu GET đến URI tài nguyên bài đăng. URI cho tài nguyên bài đăng có định dạng như sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY
Người dùng không cần được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
}
Tìm kiếm bài đăng
Bạn có thể tìm kiếm các bài đăng trên một blog bằng cách gửi yêu cầu GET đến URI tìm kiếm bài đăng với tham số truy vấn tìm kiếm q:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY
Người dùng không cần được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
},
...
]
}
Thêm bài đăng
Bạn có thể thêm bài đăng cho blog bằng cách gửi yêu cầu POST đến URI thu thập bài đăng với nội dung JSON của bài đăng:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/
Yêu cầu
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..."
}
Bạn phải được xác thực thì mới có thể tạo bài đăng.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
}
Xoá bài đăng
Bạn có thể xoá một bài đăng cho một blog bằng cách gửi yêu cầu DELETE đến URI tài nguyên bài đăng:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Yêu cầu
Dưới đây là ví dụ:
DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058 Authorization: /* OAuth 2.0 token here */
Bạn phải được xác thực thì mới có thể xoá bài đăng.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK.
Truy xuất bài đăng theo đường dẫn
Bạn có thể truy xuất bài đăng trên một blog bằng cách gửi yêu cầu GET tới URI bypath của bài đăng có tham số path. URI cho một yêu cầu bài đăng theo đường dẫn có định dạng như sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path
Yêu cầu
https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY
Người dùng không cần được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
}
Cập nhật bài đăng
Bạn có thể cập nhật một bài đăng cho một blog bằng cách gửi yêu cầu PUT đến URI tài nguyên bài đăng với nội dung JSON của bài đăng:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Yêu cầu
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..."
}
Bạn phải được xác thực thì mới có thể cập nhật bài đăng.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
}
Cập nhật bài đăng có ngữ nghĩa của bản vá
Bạn có thể cập nhật một bài đăng có ngữ nghĩa của bản vá bằng cách gửi yêu cầu PATCH đến URI tài nguyên bài đăng với phần nội dung JSON của bài đăng:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Yêu cầu
Dưới đây là ví dụ:
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..."
}
Bạn phải được xác thực thì mới có thể cập nhật bài đăng.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và nội dung bài đăng:
{
"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"
}
}
Cách xử lý bình luận
Truy xuất nhận xét cho bài đăng
Bạn có thể truy xuất danh sách bình luận cho một bài đăng bằng cách gửi yêu cầu GET đến URI thu thập bình luận. URI của một tập hợp nhận xét có định dạng như sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và danh sách các nhận xét:
{
"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
}
]
}
Truy xuất một nhận xét cụ thể
Bạn có thể truy xuất một bình luận cụ thể trong một bài đăng bằng cách gửi yêu cầu GET đến URI tài nguyên bình luận. URI cho tài nguyên nhận xét có định dạng như sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và dữ liệu nhận xét:
{
"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"
}
}
}
Cách dùng trang
Truy xuất các trang của blog
Bạn có thể truy xuất danh sách các trang cho một blog bằng cách gửi yêu cầu GET đến URI bộ sưu tập trang. URI của một tập hợp trang có định dạng sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và danh sách các trang:
{
"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"
}
}
}
]
}
Truy xuất một trang cụ thể
Bạn có thể truy xuất một trang cụ thể từ blog bằng cách gửi yêu cầu GET đến URI tài nguyên của trang. URI cho một Tài nguyên trang có định dạng như sau:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId
Yêu cầu
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY
"Người dùng không cần phải được xác thực để truy xuất blog công khai. Ứng dụng không cần thêm tiêu đề HTTP Authorization cho yêu cầu blog công khai. Tuy nhiên, bạn cần cung cấp khoá API.
Blogger cũng có blog riêng tư và blog này yêu cầu xác thực.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và dữ liệu trang:
{
"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"
}
}
}
Làm việc với người dùng
Truy xuất người dùng
Bạn có thể truy xuất thông tin của người dùng bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên của người dùng:
https://www.googleapis.com/blogger/v3/users/userId
Yêu cầu
GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */
Lưu ý: Người dùng phải được xác thực để liệt kê thông tin của riêng họ, vì vậy, bạn phải cung cấp tiêu đề HTTP Authorization cùng với yêu cầu GET.
Phản hồi
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và một đường liên kết đến danh sách blog của người dùng:
{
"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"
}
}
Tham số truy vấn chuẩn
Các tham số truy vấn sau có thể dùng với tất cả phương thức và mọi tài nguyên trong API Blogger.
Tham số truy vấn áp dụng cho mọi hoạt động của API Blogger được ghi lại trong phần Tham số hệ thống.