API Blogger: Sử dụng API
API Blogger cho phép bạn tích hợp nội dung Blogger với ứng dụng của mình bằng cách sử dụng API REST. Trước khi bạn bắt đầu, bạn sẽ cần phải thiết lập ủy 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 các trang web cho phép mọi người xuất bản suy nghĩ của họ trên cơ sở liên tục.
Cho phép yêu cầu và xác định ứ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 xác định ứng dụng của bạn với Google. Có hai 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 khóa API của ứng dụng . Dưới đây là cách xác định tùy chọn nào sẽ sử dụng:
- Nếu yêu cầu yêu cầu ủy quyền (chẳng hạn như yêu cầu dữ liệu riêng tư của một cá nhân), thì ứng dụng phải cung cấp mã thông báo OAuth 2.0 với yêu cầu. Ứng dụng cũng có thể cung cấp khóa API, nhưng nó không phải.
- Nếu yêu cầu không yêu cầu ủy 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 khóa API hoặc mã thông báo OAuth 2.0 hoặc cả hai tùy chọn bất kỳ tùy chọn nào thuận tiện nhất cho bạn.
Về giao thức ủy quyền
Ứng dụng của bạn phải sử dụng OAuth 2.0 để ủy quyền các yêu cầu. Không có giao thức ủy quyền khác được hỗ trợ. Nếu ứng dụng của bạn sử dụng Đăng nhập Google , một số khía cạnh ủy quyền sẽ được xử lý cho bạn.
Cho phép các yêu cầu với OAuth 2.0
Yêu cầu API Blogger cho dữ liệu người dùng không công khai phải được ủy quyền bởi người dùng được xác thực.
Quá trình này được tạo điều kiện với ID khách OAuth.
Các chi tiết của quy trình ủy quyền hoặc "dòng chảy" cho OAuth 2.0 khác nhau tùy 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 ứng dụng của bạn cần quyền truy cập vào dữ liệu người dùng, nó 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 đồng ý cho người dùng, yêu cầu họ cho phép ứng dụng của bạn yêu cầu một số dữ liệu của họ.
- Nếu người dùng chấp thuận, thì Google cung cấp cho ứng dụng của bạn mã thông báo truy cập ngắn hạn .
- Ứng dụng của bạn yêu cầu dữ liệu người dùng, đính kèm mã thông báo truy cập vào yêu cầu.
- Nếu Google xác định rằng yêu cầu của bạn và mã thông báo là hợp lệ, nó sẽ trả về dữ liệu được yêu cầu.
Một số luồng bao gồm các bước bổ sung, chẳng hạn như sử dụng mã thông báo làm mới để có được mã thông báo truy cập mới. Để biết thông tin chi tiết về các luồng cho các loại ứng dụng khác nhau, hãy xem tài liệu OAuth 2.0 của Google .
Đây là thông tin phạm vi OAuth 2.0 cho API Blogger:
Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cần có thông tin phạm vi, 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 khách hàng và bí mật của máy khách).
Mẹo: Thư viện khách Google API có thể xử lý một số quy trình ủy quyền cho bạn. Chúng có sẵn cho nhiều ngôn ngữ lập trình; kiểm tra trang với các thư viện và mẫu để biết thêm chi tiết.
Nhận và sử dụng khóa API
Yêu cầu API Blogger cho dữ liệu công khai phải được kèm theo một mã định danh, có thể là khóa API hoặc mã thông báo truy cập .
Sau khi bạn có khóa API, ứng dụng của bạn có thể nối tham số truy vấn vào tất cả các URL yêu cầu.
key=yourAPIKey
Khóa API an toàn để nhúng URL; nó không cần mã hóa.
Làm việc với blog
Lấy một blog
Bạn có thể truy xuất thông tin cho một blog cụ thể bằng cách gửi
GETyêu cầu HTTP đến URI của blog. URI cho một blog có định dạng sau:Yêu cầu
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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng
200 OKmã trạng thái HTTP và dữ liệu blog:Lấy một blog bằng URL của nó
Bạn có thể truy xuất blog bằng URL của nó bằng cách gửi
GET yêu cầu HTTP đến URI sau với urltham số:Yêu cầu
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và đại diện đầy đủ của blog đã xác định:Lấy blog của người dùng
Bạn có thể truy xuất danh sách các blog của người dùng bằng cách gửi
GETyêu cầu HTTP đến bộ sưu tập blog URI:Yêu cầu
Lưu ý : Người dùng phải được xác thực để liệt kê các blog của riêng họ, vì vậy bạn phải cung cấp
Authorizationtiêu đề HTTP với GETyêu cầu.Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng
200 OKmã trạng thái HTTP và thể hiện đầy đủ danh sách các blog của người dùng:Làm việc với bài viết
Lấy bài viết 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
GETyêu cầu đến URI bộ sưu tập bài đăng. URI cho bộ sưu tập bài viết có định dạng sau:Yêu cầu
Đây là một ví dụ:
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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và danh sách các bài đăng:Lấy một bài đăng cụ thể
Bạn có thể truy xuất một bài đăng cụ thể từ blog bằng cách gửi
GETyêu cầu tới URI tài nguyên bài đăng. URI cho tài nguyên bài đăng có định dạng sau:Yêu cầu
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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Tìm kiếm một bài viết
Bạn có thể tìm kiếm các bài đăng từ blog bằng cách gửi
GETyêu cầu tới URI tìm kiếm bài đăng với tham số truy vấn tìm kiếm q:Yêu cầu
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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Thêm một bài viết
Bạn có thể thêm một bài đăng cho một blog bằng cách gửi
POSTyêu cầu đến URI của bộ sưu tập bài đăng với phần thân JSON của bài đăng:Yêu cầu
Bạn phải được xác thực để tạo một bài viết.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Xóa một bài viết
Bạn có thể xóa bài đăng cho blog bằng cách gửi
DELETEyêu cầu tới URI tài nguyên bài đăng:Yêu cầu
Đây là một ví dụ:
Bạn phải được xác thực để xóa một bài viết.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng
200 OKmã trạng thái HTTP .Lấy một bài đăng bằng đường dẫn của nó
Bạn có thể truy xuất một bài đăng từ blog bằng cách gửi
GETyêu cầu đến các bài đăng bằng cách paththông qua URI với một tham số. URI cho một bài viết theo yêu cầu đường dẫn có định dạng sau:Yêu cầu
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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Cập nhật một bài viết
Bạn có thể cập nhật bài đăng cho blog bằng cách gửi
PUTyêu cầu tới URI tài nguyên bài đăng với phần thân JSON của bài đăng:Yêu cầu
Bạn phải được xác thực để cập nhật một bài viết.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Cập nhật một bài đăng với ngữ nghĩa vá
Bạn có thể cập nhật một bài đăng với ngữ nghĩa vá bằng cách gửi
PATCH yêu cầu đến URI tài nguyên bài đăng với phần thân JSON của bài đăng:Yêu cầu
Đây là một ví dụ:
Bạn phải được xác thực để cập nhật một bài viết.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và nội dung của bài đăng:Làm việc với ý kiến
Lấy ý kiến cho một bài viết
Bạn có thể truy xuất danh sách các bình luận cho một bài đăng bằng cách gửi
GETyêu cầu đến URI bộ sưu tập ý kiến. URI cho bộ sưu tập nhận xét có định dạng sau:Yêu cầu
"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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và danh sách các bình luận:Lấy một bình luận 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
GETyêu cầu tới URI tài nguyên nhận xét. URI cho tài nguyên nhận xét có định dạng sau:Yêu cầu
"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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và dữ liệu nhận xét:Làm việc với các trang
Lấy trang cho blog
Bạn có thể truy xuất danh sách các trang cho blog bằng cách gửi
GETyêu cầu đến URI bộ sưu tập trang. URI cho bộ sưu tập trang có định dạng sau:Yêu cầu
"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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và danh sách các trang:Lấy 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
GETyêu cầu tới URI tài nguyên trang. URI cho một trang Tài nguyên có định dạng sau:Yêu cầu
"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
Authorizationtiêu đề HTTP cho yêu cầu blog công khai; tuy nhiên, bạn cần phải cung cấp khóa API.
Blogger cũng có blog riêng, yêu cầu xác thực.
Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng
200 OKmã trạng thái HTTP và dữ liệu trang:Làm việc với người dùng
Lấy mộ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
GETyêu cầu HTTP đến URI tài nguyên của người dùng:Yêu cầu
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
Authorizationtiêu đề HTTP với GETyêu cầu.Phản ứng
Nếu yêu cầu thành công, máy chủ sẽ phản hồi với
200 OKmã trạng thái HTTP và liên kết đến danh sách các blog của người dùng:Thông số truy vấn tiêu chuẩn
Các tham số truy vấn sau đây có thể được sử dụng với tất cả các phương thức và tất cả tài nguyên trong API Blogger.
Các tham số truy vấn áp dụng cho tất cả các hoạt động API Blogger được hiển thị trong bảng bên dưới.
Ghi chú (trên khóa API và mã xác thực authens):
- Các
keytham số là cần thiết với tất cả các yêu cầu, trừ khi bạn cung cấp một OAuth 2.0 mã thông báo với yêu cầu. - Bạn phải gửi mã thông báo ủy quyền với mọi yêu cầu yêu cầu phạm vi OAuth. OAuth 2.0 là giao thức ủy quyền được hỗ trợ duy nhất.
- Bạn có thể cung cấp mã thông báo OAuth 2.0 với bất kỳ yêu cầu nào theo một trong hai cách:
- Sử dụng
access_tokentham số truy vấn như thế này:?access_token=oauth2-token - Sử dụng
Authorizationtiêu đề HTTP như thế này:Authorization: Beareroauth2-token
- Sử dụng
Tất cả các tham số là tùy chọn trừ khi có ghi chú.
| Tham số | Ý nghĩa | Ghi chú |
|---|---|---|
access_token | Mã thông báo OAuth 2.0 cho người dùng hiện tại. |
|
callback | Chức năng gọi lại. | |
fields | Bộ chọn chỉ định tập hợp con của các trường để đưa vào phản hồi. |
|
key | Mã API. (CẦN THIẾT*) |
|
prettyPrint |
Trả về phản hồi với các vết lõm và ngắt dòng.
|
|
quotaUser | Thay thế cho userIp. |
|
userIp | Địa chỉ IP của người dùng cuối mà cuộc gọi API đang được thực hiện. |
|
https://www.youtube.com/watch?v=cqIGCb9mTRU


Một số lưu ý khi bình luận
Mọi bình luận sai nội quy sẽ bị xóa mà không cần báo trước (xem nội quy)
Bấm Thông báo cho tôi bên dưới khung bình luận để nhận thông báo khi admin trả lời
Để bình luận một đoạn code, hãy mã hóa code trước nhé