Получает список сообщений. Попробуйте сейчас или посмотрите пример .
Авторизация требуется, если сообщения находятся в частном блоге. Если публикации находятся в общедоступном блоге, то этот метод можно вызвать без авторизации.
Запрос
HTTP-запрос
GET https://www.googleapis.com/blogger/v3/blogs/blogId /posts
Параметры
Имя параметра | Ценить | Описание |
---|---|---|
Обязательные параметры | ||
blogId | string | Идентификатор блога, из которого нужно получать сообщения. |
Дополнительные параметры | ||
endDate | datetime | Дата последней публикации для получения: date-time в формате RFC 3339 . |
fetchBodies | boolean | Включено ли основное содержимое сообщений (по умолчанию: true). Если тела сообщений не требуются, для этого параметра следует установить значение false, чтобы минимизировать трафик. (По умолчанию: true ) |
fetchImages | boolean | Включены ли метаданные URL-адреса изображения для каждого сообщения. |
labels | string | Список ярлыков, разделенных запятыми, для поиска. |
maxResults | unsigned integer | Максимальное количество сообщений для получения. |
orderBy | string | Порядок сортировки, примененный к результатам. Приемлемые значения:
|
sortOption | string | UNAVAILABLE NOW Направление сортировки, примененное к результатам. Приемлемые значения:
|
pageToken | string | Токен продолжения, если запрос отправлен на страницу. |
startDate | datetime | Дата самой ранней публикации для получения: date-time в формате RFC 3339 . |
status | string | Приемлемые значения:
|
view | string | Приемлемые значения:
|
Тело запроса
Не предоставляйте тело запроса с помощью этого метода.
Ответ
В случае успеха этот метод возвращает тело ответа следующей структуры:
{ "kind": "blogger#postList", "nextPageToken":string , "items": [ posts Resource ] }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
kind | string | Вид этой сущности. Всегда blogger#postList . | |
nextPageToken | string | Токен нумерации страниц для перехода на следующую страницу, если таковая существует. | |
items[] | list | Список сообщений для этого блога. |
Примеры
Примечание. Примеры кода, доступные для этого метода, не представляют все поддерживаемые языки программирования (список поддерживаемых языков см. на странице клиентских библиотек ).
Использует клиентскую библиотеку Java
// The BlogId for the Blogger Buzz blog String BUZZ_BLOG_ID = "2399953";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-PostsList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");
// This step sends the request to the server.
PostList posts = postsListAction.execute();
// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
for (Post post : posts.getItems()) {
System.out.println("Post #"+ ++postCount);
System.out.println("\tTitle: "+post.getTitle());
System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
System.out.println("\tPublished: "+post.getPublished());
System.out.println("\tURL: "+post.getUrl());
System.out.println("\tContent: "+post.getContent());
}
// Pagination logic
String pageToken = posts.getNextPageToken();
if (pageToken == null || ++pageCount >= 5) {
break;
}
System.out.println("-- Next page of posts");
postsListAction.setPageToken(pageToken);
posts = postsListAction.execute();
}