PostUserInfos: список
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Требуется авторизация
Получает список пар сообщений и сообщений о пользователях, возможно, отфильтрованных. Информация о пользователе публикации содержит информацию о публикации для каждого пользователя, такую как права доступа, специфичные для пользователя. Попробуйте сейчас .
Запрос
HTTP-запрос
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Параметры
| Имя параметра | Ценить | Описание |
|---|
| Обязательные параметры |
blogId | string | Идентификатор блога, из которого нужно получать сообщения. |
userId | string | Идентификатор пользователя для получения информации о каждом пользователе. Либо слово «я» (без кавычек), либо идентификатор профиля пользователя. |
| Дополнительные параметры |
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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации 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."]]
