Posts：list

擷取訊息清單。 立即試用或查看範例。

如果文章所在網誌為私人網誌，則必須取得授權。如果文章位於公開的網誌上，則無需授權即可呼叫此方法。

要求

HTTP 要求

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

參數

參數名稱	值	說明
必要參數
blogId	string	要擷取文章的來源網誌 ID。
選用參數
endDate	datetime	要擷取的最新張貼日期，這是採用 RFC 3339 格式的 date-time。
fetchBodies	boolean	是否包含文章的內文內容 (預設值：true)。在不需要貼文主體時，這個欄位應設為 false，以將流量降到最低。 (預設值：true)
fetchImages	boolean	是否包含每則貼文的圖片網址中繼資料。
labels	string	要搜尋的標籤清單 (以半形逗號分隔)。
maxResults	unsigned integer	要擷取的文章數量上限。
orderBy	string	排序已套用至結果的順序。 可接受的值為： 「published」：依照貼文發布日期排序 「updated」：依貼文上次更新日期排序
sortOption	string	UNAVAILABLE NOW 對結果套用排序方向。 可接受的值為： 「descending」：依時間遞減排序貼文 (預設) 「ascending」：以遞增方式排序貼文
pageToken	string	要求已分頁時的接續權杖。
startDate	datetime	要擷取的最早張貼日期，這是一種採用 RFC 3339 格式的 date-time。
status	string	可接受的值為： 「draft」：草稿貼文 「live」：已發布的文章 「scheduled」：已排定於日後發布的貼文。
view	string	可接受的值為： 「ADMIN」：管理員層級詳細資料 「AUTHOR」：作者層級詳細資料 「READER」：讀者層級詳細資料

要求主體

請勿使用這個方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}

屬性名稱	值	說明	附註
kind	string	這個實體的種類。一律為 blogger#postList。
nextPageToken	string	用於擷取下一頁 (如果有的話) 的分頁符記。
items[]	list	這個網誌的文章清單。

範例

注意：這個方法適用的程式語言眾多，我們只在此提供部分程式碼範例，完整的支援語言清單請參閱用戶端程式庫頁面。

Java

使用 Java 用戶端程式庫

// The BlogId for the Blogger Buzz 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-PostsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");

// This step sends the request to the server.
PostList posts = postsListAction.execute();

// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Post #"+ ++postCount);
		System.out.println("\tTitle: "+post.getTitle());
		System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
		System.out.println("\tPublished: "+post.getPublished());
		System.out.println("\tURL: "+post.getUrl());
		System.out.println("\tContent: "+post.getContent());
	}

	// Pagination logic
	String pageToken = posts.getNextPageToken();
	if (pageToken == null || ++pageCount >= 5) {
		break;
	}
	System.out.println("-- Next page of posts");
	postsListAction.setPageToken(pageToken);
	posts = postsListAction.execute();
}

試試看！

使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。