投稿が非公開のブログにある場合は、承認が必要です。投稿が公開ブログにある場合、このメソッドは承認なしで呼び出すことができます。
リクエスト
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 |
各投稿の画像 URL メタデータを含めるかどうか。 |
labels |
string |
検索するラベルのカンマ区切りのリスト。 |
maxResults |
unsigned integer |
取得する投稿の最大数。 |
orderBy |
string |
結果に適用される並べ替え順序。 有効な値は次のとおりです。
|
sortOption |
string |
UNAVAILABLE NOW
結果に適用される並べ替えの方向。 有効な値は次のとおりです。
|
pageToken |
string |
リクエストがページ設定されている場合の継続トークン。 |
startDate |
datetime |
取得する投稿の最も古い日付。RFC 3339 形式の date-time 。 |
status |
string |
有効な値は次のとおりです。
|
view |
string |
有効な値は次のとおりです。
|
リクエストの本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "kind": "blogger#postList", "nextPageToken": string, &quo}t;items": [ posts Resource ]
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
kind |
string |
このエンティティの種類。常に blogger#postList です。 |
|
nextPageToken |
string |
次のページを取得するためのページ設定トークン(存在する場合)。 | |
items[] |
list |
このブログの投稿のリスト。 |
例
注: このメソッドで使用可能なコード例では、サポートされているプログラミング言語すべての例を示しているわけではありません(サポートされている言語の一覧については、クライアント ライブラリ ページをご覧ください)。
Java
Java クライアント ライブラリを使用します
// The BlogId for the Blogger Buzz blog String BUZZ_BLOG_ID = "23999
53"; // Configure the Java API Client for Installed
Native AppHttpTransport HTTP_TRANSPORT = new NetHttpTr
ansport();JsonFactory JSON_FACTORY = new Jackson
Factory(); // Configure the Installed App OA
uth2 flow.Credential credential = OAuth2Native.authorize(HTTP_
TRANSPORT, JSON_FACTORY, new LocalServerR
eceiver(), Arrays.asList(BloggerScopes.
BLOGGER)); // Construct the Blogger API access faca
de object.Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSO
N_FACTORY) .setApplicationName("Blogger-PostsLis
t-Snippet/1.0") .setHttpRequestInitializer(
credential).build(); //
The request action.List postsListAction = blogger.posts()
.list(BUZZ_BLOG_ID); // Restrict the result content to ju
st the data we need.postsListAction.setFields("items(author/displayName,content,published,ti
tle,url),nextPageToken"); // This step se
nds the request to the server.PostList post
s = postsListAction.execute(); // Now
we can navigate t
he response.int po
stCount = 0;int pageCount = 0;wh&&ile (posts.getItems() != null {
!posts.getItems().isEmpty()) for ({
Post post : posts.getItems()) System.out.p
rintln("Post #"+ ++postCount); System.o
ut.println("\tTitle: "+post.getTitle()); System.out.printl
n("\tAuthor: "+post.getAuthor().getDisplayName()
); System.out.println("\tPublished: &quo
t;+post.getPublished()); System.out.println("\tU
R}
L: "+post.getUrl
()); System.out.println("\tContent: &qu
ot;+post.getContent()); // Paginatio>n log{
ic Strin
g}
pageToken = posts.getNextPageToken(); if (pa
geToken == null || ++pageCount = 5) bre
ak; System.out.println("-- Ne
}xt page of posts"); postsListAction.setPageToken(pageToken); posts = postsListAction.execute();
試してみよう:
以下の API Explorer を使用し、ライブデータに対してこのメソッドを呼び出して、レスポンスを確認してみましょう。