Сообщения: список

Получает список сообщений. Попробуйте сейчас или посмотрите пример .

Авторизация требуется, если сообщения находятся в частном блоге. Если публикации находятся в общедоступном блоге, то этот метод можно вызвать без авторизации.

Запрос

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 Порядок сортировки, примененный к результатам.

Приемлемые значения:
  • « published »: сортировка по дате публикации сообщения.
  • « updated »: сортировка по дате последнего обновления сообщения.
sortOption string UNAVAILABLE NOW

Направление сортировки, примененное к результатам.

Приемлемые значения:
  • « descending »: сортировать сообщения по убыванию времени (по умолчанию).
  • « ascending »: сортировать сообщения по возрастанию во времени.
pageToken string Токен продолжения, если запрос отправлен на страницу.
startDate datetime Дата самой ранней публикации, которую нужно получить, date-time в формате RFC 3339 .
status string

Приемлемые значения:
  • « draft »: Черновики сообщений.
  • « live »: Опубликованные посты
  • « scheduled »: сообщения, которые планируется опубликовать в будущем.
view string

Приемлемые значения:
  • « ADMIN »: сведения об уровне администратора.
  • « AUTHOR »: детализация уровня автора.
  • « READER »: детализация уровня читателя.

Тело запроса

Не предоставляйте тело запроса с помощью этого метода.

Ответ

В случае успеха этот метод возвращает тело ответа следующей структуры:

{
  "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();
}

Попробуй это!

Используйте API-обозреватель ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ.