PostUserInfos: 목록
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
승인 필요
게시물 및 게시물 사용자 정보 쌍의 목록을 가져옵니다(필터링될 수 있음). 게시물 사용자 정보에는 사용자별 액세스 권한과 같은 게시물에 대한 사용자별 정보가 포함됩니다.
지금 사용해 보기
요청
HTTP 요청
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
매개변수
| 매개변수 이름 |
값 |
설명 |
| 필수 매개변수 |
blogId |
string |
게시물을 가져올 블로그의 ID입니다.
|
userId |
string |
가져올 사용자별 정보의 사용자 ID입니다. 'self'라는 단어(따옴표 제외) 또는 사용자의 프로필 식별자입니다.
|
| 선택적 매개변수 |
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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-30(UTC)
[null,null,["최종 업데이트: 2024-11-30(UTC)"],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
