PostUserInfo: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」:讀者層級詳細資料

授權

這項要求需要授權,且至少包含下列其中一個範圍 (進一步瞭解驗證和授權)。

範圍
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,針對即時資料呼叫這個方法,然後查看回應。