需要授權
擷取貼文和貼文使用者資訊組合的清單,可能會篩選。貼文使用者資訊包含貼文的個別使用者資訊,例如特定使用者的存取權。立即試用。
要求
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 。可接受的值如下:
|
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 ] }
屬性名稱 | 值 | 說明 | 附註 |
---|---|---|---|
kind |
string |
這個實體的類型。一律使用 blogger#postList |
|
nextPageToken |
string |
用來擷取下一頁的分頁符記 (如有)。 | |
items[] |
list |
這個網誌的貼文清單,其中包含貼文的使用者資訊。 |
試試看!
您可以使用下方的 API Explorer,針對即時資料呼叫這個方法,然後查看回應。