API Blogger cho phép bạn tích hợp nội dung trên Blogger với ứng dụng bằng cách sử dụng API REST. Trước khi bắt đầu, bạn cần thiết lập 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 ứ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 mình trên cơ sở liên tục.
Nếu bạn chưa quen với các khái niệm trên Blogger, bạn nên đọc phần Bắt đầu trước khi bắt đầu lập trình.
Cấp phép cho các yêu cầu và xác định ứng dụng
Mọi yêu cầu mà ứng dụng của bạn gửi tới các API của 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 đã ủy quyền cho yêu cầu) và/hoặc sử dụng khóa API của ứng dụng. Sau đây là cách xác định tuỳ chọn nào trong số đó để sử dụng:
- Nếu yêu cầu cần được cho phép (chẳng hạn như yêu cầu về dữ liệu riêng tư của một cá nhân), ứng dụng phải cung cấp mã thông báo OAuth 2.0 theo yêu cầu. Ứng dụng cũng có thể cung cấp khoá API, nhưng không bắt buộc.
- Nếu yêu cầu không yêu cầu uỷ quyền (chẳng hạn như yêu cầu dữ liệu công khai), thì ứng dụng phải cung cấp khoá API hoặc mã thông báo OAuth 2.0 hoặc cả hai — bất kỳ tuỳ chọ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
Yêu cầu API Blogger đối với dữ liệu không công khai của người dùng phải được một người dùng đã xác thực cấp phép.
Quá trình này được thực hiện thông qua mã ứng dụng khách OAuth.
Lấy mã ứng dụng khách OAuthHoặc tạo một mã trong trang Thông tin xác thực.
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 truy cập của OAuth 2.0 cho 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ư ID ứng dụng khách và khoá bí mật của ứng dụng).
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.
Thu nạp và sử dụng khoá API
Các yêu cầu gửi cho API Blogger về dữ liệu công khai phải đi kèm với giá trị nhận dạng, có thể là khóa API hoặc mã truy cập.
Nhận khoáHoặc tạo một mã trong trang Thông tin xác thực.
Sau khi bạn có khóa API, ứng dụng có thể thêm tham số truy vấn key=yourAPIKey
vào tất cả URL yêu cầu.
Khóa API an toàn để nhúng vào URL; nó không cần bất kỳ mã hóa 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 xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồ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ó các blog riêng tư 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 bằng URL
Bạn có thể truy xuất một blog bằng URL của blog đó bằng cách gửi yêu cầu HTTP GET
tới URI sau 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 200 OK
HTTP và nội dung trình bày đầy đủ về 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 GET
HTTP đến URI thu thậ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
kèm theo 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 200 OK
HTTP và nội dung trình bày đầy đủ về 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": "" } } ] }
Làm việc với 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 từ một blog nhất định bằng cách gửi yêu cầu GET
tới URI thu thập bài đăng. URI cho một 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 xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồ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ó các blog riêng tư 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 200 OK
và danh sách 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 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 của bài đăng đó. URI cho tài nguyên bài đăng có định dạng 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 xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồ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ó các blog riêng tư 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 của 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 các bài đăng từ một blog bằng cách gửi một yêu cầu GET
đến URI tìm kiếm bài đăng thông qua cụm từ tìm kiếm:
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 xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồ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ó các blog riêng tư 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 của 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 có phần nội dung JSON đă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 để 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 của 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" } }
Xóa bài đăng
Bạn có thể xoá một bài đăng trên 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 để xóa 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 một bài đăng từ blog bằng cách gửi yêu cầu GET
đến URI đường dẫn bài đăng với tham số path
. URI cho một bài đăng theo yêu cầu đường dẫn có định dạng 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 xác thực để truy xuất blog công khai. Ứng dụng không cần bao gồ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ó các blog riêng tư 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 của 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 blog bằng cách gửi yêu cầu PUT
đến URI tài nguyên bài đăng với phần nội dung JSON đă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 để 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 của 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 bằng 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 đă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 để 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 của 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" } }
Làm việc với 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 các nhận xét cho bài đăng bằng cách gửi yêu cầu GET
đến URI thu thập nhận xét. URI cho một bộ sưu tập nhận xét có định dạng 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 bao gồ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ó các blog riêng tư 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 200 OK
và danh sách 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 nhận xét cụ thể
Bạn có thể truy xuất một nhận xét cụ thể từ một bài đăng bằng cách gửi yêu cầu GET
đến URI tài nguyên của nhận xét. URI cho một tài nguyên nhận xét có định dạng 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 bao gồ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ó các blog riêng tư 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" } } }
Làm việc với các trang
Truy xuất trang cho 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 thu thập trang. URI cho một bộ sưu tậ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 bao gồ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ó các blog riêng tư 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 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 trang cụ thể
Bạn có thể truy xuất một trang cụ thể từ mộ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 trên trang có định dạng 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 bao gồ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ó các blog riêng tư 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 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
tới 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
kèm theo 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à đường liên kết đến danh sách các 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
Bạn có thể sử dụng các tham số truy vấn sau với tất cả các phương thức và tất cả tài nguyên trong các API Blogger.
Bạn có thể ghi lại các tham số truy vấn áp dụng cho mọi hoạt động của API Blogger tại Thông số hệ thống.