需要授權
擷取訊息及訊息使用者資訊組合清單 (可能經過篩選)。訊息的使用者資訊包含每位使用者的訊息資訊,例如使用者的存取權限。 立即試用。
要求
HTTP 要求
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
參數
參數名稱 | 值 | 說明 |
---|---|---|
必要參數 | ||
blogId |
string |
擷取文章的來源網誌 ID。 |
userId |
string |
要擷取的使用者資訊之使用者 ID。「自我」(也就是引號) 或使用者的個人資料識別碼。 |
選用參數 | ||
endDate |
datetime |
要擷取的最晚發布日期,採用 RFC 3339 格式的日期時間。 |
fetchBodies |
boolean |
是否包含貼文的內文內容。預設值為 false 。(預設:false )
|
labels |
string |
要搜尋的標籤清單 (以半形逗號分隔)。 |
maxResults |
unsigned integer |
可擷取的文章數量上限。 |
orderBy |
string |
排序作業已套用至搜尋結果。預設值為 published 。
可接受的值如下:
|
pageToken |
string |
用於將大型結果集分頁的接續權杖。如要取得下一頁的結果,請將這個參數設為前一個回應的「nextPageToken」值。 |
startDate |
datetime |
要擷取的最早日期,採用 RFC 3339 格式的日期與時間。 |
status |
string |
可接受的值如下:
|
view |
string |
可接受的值如下:
|
授權
此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
要求主體
請不要透過此方法提供請求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{ "kind": "blogger#postUserInfosList", "nextPageToken": string, "items": [ postUserInfos Resource ] }
屬性名稱 | 值 | 說明 | Notes |
---|---|---|---|
kind |
string |
這個實體的種類。一律blogger#postList |
|
nextPageToken |
string |
用於擷取下一頁的分頁符記 (如果有的話)。 | |
items[] |
list |
此網誌中含使用者資訊的文章清單。 |
試試看!
使用 APIs Explorer 針對即時資料呼叫這個方法,並查看回應。