PostUserInfos: list

認証が必要です

投稿と投稿ユーザー情報のペアのリストを取得します。結果をフィルタできます。投稿ユーザー情報には、ユーザー固有のアクセス権など、投稿に関するユーザーごとの情報が含まれます。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 説明
必須パラメータ
blogId string 投稿を取得するブログの ID。
userId string フェッチするユーザーごとの情報のユーザー ID。「self」という単語(引用符なし)またはユーザーのプロフィール ID。
オプション パラメータ
endDate datetime 取得する最新の投稿日(RFC 3339 形式の日時)。
fetchBodies boolean 投稿の本文を返すかどうか。デフォルトは false です。(デフォルト: false
labels string 検索するラベルのカンマ区切りのリスト。
maxResults unsigned integer 取得する投稿の最大数。
orderBy string 検索結果に適用される並べ替え順序。デフォルトは published です。

有効な値は次のとおりです。
  • published」: 投稿の公開日順に並べ替えます
  • updated」: 投稿が最後に更新された日付で並べ替えます
pageToken string 大量の結果セットのページ割り付けに使用される、継続トークンです。次のページの結果を取得するには、このパラメータを前のレスポンスの「nextPageToken」の値に設定します。
startDate datetime 取得する最小投稿日(RFC 3339 形式の日時)。
status string

有効な値は次のとおりです。
  • draft」: 下書き投稿
  • live」: 公開済みの投稿
  • scheduled」: 今後公開が予定されている投稿。
view string

有効な値は次のとおりです。
  • ADMIN」: 管理者レベルの詳細
  • AUTHOR」: 作成者レベルの詳細
  • READER」: 読者レベルの詳細

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。

スコープ
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "blogger#postUserInfosList",
  "nextPageToken": string,
  "items": [
    postUserInfos Resource
  ]
}
プロパティ名 説明 メモ
kind string このエンティティの種類。常に blogger#postList です。
nextPageToken string 次のページを取得するためのページ設定トークン(存在する場合)。
items[] list このブログの投稿のユーザー情報を含む投稿のリスト。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認します。