Các trang: danh sách

Truy xuất danh sách trang cho blog. Thử ngay hoặc xem ví dụ.

Cần có uỷ quyền nếu những trang đó nằm trên một trang web riêng tư. Nếu các trang nằm trên một blog công khai, thì phương thức này có thể được gọi mà không cần uỷ quyền.

Yêu cầu

Yêu cầu HTTP

GET https://www.googleapis.com/blogger/v3/blogs/blogId/pages

Các tham số

Tên thông số Giá trị Mô tả
Các thông số bắt buộc
blogId string Mã của blog để tìm nạp trang.
Tham số không bắt buộc
fetchBodies boolean Liệu có truy xuất được nội dung Trang hay không.
status string

Các giá trị được chấp nhận là:
  • "draft": Trang nháp (chưa xuất bản)
  • "imported": Những trang đã bị xóa nội dung
  • "live": Các trang được hiển thị công khai
view string

Các giá trị được chấp nhận là:
  • "ADMIN": Thông tin chi tiết về cấp quản trị
  • "AUTHOR": Thông tin chi tiết về cấp độ tác giả
  • "READER": Thông tin chi tiết về cấp quản trị

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi với cấu trúc sau:

{
  "kind": "blogger#pageList",
  "items": [
    pages Resource
  ]
}
Tên tài sản Giá trị Mô tả Ghi chú
kind string Loại của thực thể này. Luôn luôn blogger#pageList
items[] list Danh sách Tài nguyên Trang dành cho blog đã chỉ định.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Sử dụng thư viện ứng dụng Java

// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-PagesList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List pagesListAction = blogger.pages().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
pagesListAction.setFields("items(content,title,updated,url)");
// This step sends the request to the server.
PageList pages = pagesListAction.execute();
// Now we can navigate the response.
if (pages.getItems() != null && !pages.getItems().isEmpty()) {
for (Page page : pages.getItems()) {
System.out.println("Title: " + page.getTitle());
System.out.println("URL: " + page.getUrl());
System.out.println("Last Updated:" + page.getUpdated());
System.out.println("Content: " + page.getContent());
}
}

Hãy dùng thử!

Hãy dùng API Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.