需要授權
擷取貼文清單並發布可能經過篩選的使用者資訊組合。貼文使用者資訊包含貼文個別使用者的資訊,例如存取權。 立即試用。
要求
HTTP 要求
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
參數
參數名稱 | 價值 | 說明 |
---|---|---|
必要參數 | ||
blogId |
string |
要擷取文章的來源網誌 ID。 |
userId |
string |
要擷取個別使用者資訊的使用者 ID。使用者的個人資料 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,針對即時資料呼叫這個方法,然後查看回應。